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PREFACE 



The MRX/OS Control Program and Data Management 
Services are discussed in two separate documents, 
each designed for a specific type of input/output 
(I/O) level user. The Basic Reference manual contains 
information at the logical I/O level of processing, 
where the blocking and deblocking of data is done for 
the user. This document, the Extended Reference 
manual, is designed for the block and physical I/O 
level user. Block I/O level processing recognizes no 
logical records; therefore, all data is read or written as 
a data block. The physical I/O level of processing 
allows the user to do his own processing of data. 

Chapter 7 of this document contains all the macros 
required for block and physical I/O level processing. 
Appendix B contains the expansions of these macros 
with the standard system suffixes listed. 

Related information may be found in the following 
documents. 

n MRX/OS Control Language Services, 
Extended Reference 

« MRX/OS Control Program and Data 
Management Services, Basic Reference 

» MRX/OS Assembler Reference 
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1. INTRODUCTION 



ENVIRONMENT 

The logical, block and physical input-output facilities 
and control program services described in this manual 
are all available on the MRX/OS nominal system,* All 
except for those flagged are also available on the 
MRX/OS minimal system. t Since MRX/OS is a 
disc-resident system, a minimum of one disc drive is 
required for the system disc pack. 



DESCRIPTION 

The services described in this manual are those 
provided by the central part of the operating 
systemtt. Access to these services, which are mainly 
concerned with input/output processing, is through 
system macro instructions. 



*The nominal system has a minimum main storage size of 
24K bytes, including a system region of 10K bytes. 

tThe minimal system has a minimum main storage size of 
16K bytes, including a system region of 8K bytes. 

tt Other operating system services, such as job control, link 
editing and library utilities, are described in separate 
manuals. 



INPUT/OUTPUT LEVELS 

GENERAL 

An Assembly Language programmer may code his 
input/output implementation at three different 
levels: the logical, block, and physical levels. The 
logical level is processed by the Data Management 
system while the block and physical levels are 
processed directly by the system's basic input/output 
routines (upon which Data Management depends). 

The logical level, the highest level, is the easiest to 
use. The block level provides greater flexibility but is 
still dependent on the standard system data file 
structures. The physical level is the most involved, 
regarding coding, but provides the greatest flexibility, 
including independence from the system's file 
structures. 



LOGICAL INPUT/OUTPUT 

Logical input/output coding (described in the Control 
Program and Data Management Services, Basic 
Reference and in Section 2 of this book) is normally 
employed in situations where no special handling of a 
condition such as end-of-file is required and the 
amount of available storage space is not especially 
restricted (though careful coding will still enable the 
programmer to economize on storage space). The 
chief advantage of logical input/output is the 
simplicity of coding for most common input/output 
applications. 
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BLOCK INPUT/OUTPUT 

Block input/output coding (described in Section 3) 
enables the programmer to create an object program 
smaller than would result from logical input/output, 
since the large genera I -pur pose GET /PUT subroutines 
are not included. When the user's input/output 
application is limited to a certain particular type of 
operation, block input/output produces a smaller, 
more efficient program but involves more work in 
writing the code. Block input/output is also necessary 
in the case where some special handling of abnormal 
conditions is required. 



PHYSICAL INPUT/OUTPUT 

Physical input/output coding (described in Section 4) 
is used where the user desires to create and process 
his own special external data structures for some 
special application, or where some special 
input/output device such as a plotter is being used. 
(The standard system files may also be processed by 
physical input/output if desired, though this would 
rarely be done in practice.) 



IMPLEMENTATION METHOD 

Ultimately, whether logical, block, or physical I/O is 
being used, all input/output implementation is 
performed by the system's input/output drivers. The 
basic mode of communication with the drivers is 
always the same; it involves supplying them with a 
"command program", which is a contiguous group of 
command control blocks, each one calling for the 
execution of a specific I/O operation. 

The physical input/output user must create these 
command programs himself with physical 
input/output macros, and issue do input/output 
macros which instruct the system to execute them. 
The block input/output user, on the other hand, 
simply codes the appropriate block input/output 
macro; in this case the system builds the command 
program and executes it. At the logical input/output 
level (data management) the system performs certain 
pre- or post-processing of data connected with the 
logical data file structure before or after it passes 
control to the block input/output level for 
implementation of the actual data transfer. 
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2. DATA STRUCTURES 



The structure of records, labels, and files is discussed 
in connection with their use. The Control Program 
and Data Management Services, Basic Reference 

discusses the general data structures. This manual 
gives the specific description of labels and tables. 



FILES AND RECORDS 

Data Management supports records that have the 
common stored data format, which include logical 
record headers and may include space headers in each 
block of data. If the block I/O user elects to use the 
common stored data format, he must specify CSD = 
YES on the Control Language //DEFINE card to 
allocate a block size sufficient for the required 
headers. The control information (record headers and 
space headers) is managed by Data Management for 
logical I/O users. However, block I/O level or physical 
I/O level users must generate or process the control 
information if the common stored data format is 
used. The common stored data format is used only 
for data located in mass storage; thus data stored on 
unit record devices does not have this format; and 
this format is not applied to such data by the block 
I/O level READ function (Section 7, Macros). 

Records may be variable length or fixed length 
limited only by file organization and devices; that is, 
only fixed-length records can be used for unit record 
devices. 

Three file organizations, which produce a variety of 
applications, are available for the user: sequential, 
relative, and indexed. At the logical I/O level, two 
access methods are provided — sequential and 
random. At the block I/O level, each access is by 
specified block (random) or by implied next block 
(sequential, by adding one to the access count). 
Sequential access is provided for all three file 
organizations; however, random access is limited to 
relative or indexed files. 



A more detailed discussion of file and record 
structures is in the Control Program and Data 
Management Services, Basic Reference. 



LABELS 

Two types of identification are associated with a disc 
pack or tape reel: external (such as a sticker) and 
internal (labels). This section is concerned with the 
internal identification, namely the labels. 

The internal identification serves two purposes. 

1. Labels protect files from careless mistakes 
resulting from the user's disregard for external 
labeling. 

2. Labels specify the location of data on files and 
store variable file information. 

Tapes are identified by both volume and file labels; 
the disc files have volume labels and central and/or 
pack catalogs. 



TAPE LABELS 

The MRX 40 and 50 Systems have two types of tape 
labels: volume labels and file labels. 

The volume label is found at the beginning of a tape 
reel and the file label at the beginning of a file. Tape 
marks separate files and their associated labels on a 
tape reel. 

The volume label (Figure 2-1 ) is identified by the 
characters, VOL, found in the first three positions. 
The volume label number is always 1 for 
compatibility with IBM. The volume serial number 
occupies positions 4 through 9 and identifies the 
volume; and a unique owner name and address code 
identifies the installation. 
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BYTE 

3 


VOL 


4 
9 


VOLUME IDENTIFIER 


10 




11 


STATE OF VOLUME 


12 
21 


POINTER TO VTOC (VOLUME 

TABLE OF CONTENTS) ONLY ON 

CONVERTED IBM PACKS 


22 


DEVICE TYPE 


23 




24 
25 


PACK CATALOG ADDRESS 


26 






Figure 2-1 . Standard Tape Volume Label 



The standard tape file label (Figure 2-2) provides 
information concerning the user's file such as creation 
and expiration dates, file label number, file name, and 
sequence number. 

The label identification field identifies the type of 
standard label with a three letter abbreviation. Three 
types supported by the system are header labels 
(HDR), end-of-file labels (EOF), and end-of-volume 
labels (EOV). The file serial number found in 
positions 22-27 is identical to the volume serial 
number in the volume label. The volume sequence 
number identifies the order of the volume of data 
records in a multi-volume logical file. The block 
count provides the number of physical records 
written in a file at creation. 



BYTE 

1 
2 
3 
4 



21 



40 
41 



46 
47 



59 
60 



79 



LABEL IDENTIFICATION 



FILE LABEL NUMBER 



FILENAME 



FILE SERIAL NUMBER 



VOLUME SEQUENCE NUMBER 



CREATION DATE 



EXPIRATION DATE 



BLOCK COUNT 



HDR 
EOF 
EOV 
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DISC LABEL 

Disc files must be labeled with volume and actual file 
identification (Figure 2-3). The disc pack volume 
label is written by the Pack Initialize Utility Routine 
(MRX/OS Utility Programs Reference). The volume 
label identifies the volume; gives the state of the 
volume — unrestricted (0), restricted (1), or locked 
(2), - device type, owner; and gives the starting track 
address of the pack catalog for this volume. The 
actual file identification is found in the disc catalogs. 



Figure 2-2. Standard Tape File Label 
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BYTE 
1 
2 


VOL 


3 


VOLUME LABEL NUMBER 


4 




VOLUME SERIAL NUMBER 


9 






10 




■ 


40 




- 


41 
50 


OWNER NAME 

AND 
ADDRESS CODE 


51 







-EQUALS 1 




Figure 2-3. Disc Label 



DISC STORAGE CATALOGS 

The space management routines, in performing their 
functions, maintain the central catalog and pack 
catalogs on disc. The pack catalog, existing on each 
volume, contains an entry for each file occupying 
space on the volume. The entry identifies the file and 
describes the space occupied by the file. 



The pack catalog entry is generally divided into the 
following three elements, each having the form of a 
common stored data format. 

• Name element, to identify the file 

detail 



• Attribute element, to 
characteristics of the file 



various 



• Space element, to define the space occupied 
by the file 

The central catalog, existing once for a system, 
contains an entry for each file cataloged in the 
system. The entry identifies the file and describes the 
volumes occupied by the file. The central catalog also 
consists of three elements: 

• Name element, to identify the file 

• Attribute element, to detail characteristics 
of the file 

• Volume element, to define the volumes 
occupied by the file 



Allowance is made in the catalog structure for 
overflow from a pack catalog space element or central 
catalog volume element. These elements are known as 
element continuations: space element continuation 
and volume element continuation. 

Tables 2-1 through 2-4 explain format of the four 
basic elements and the two element continuations. At 
the beginning of each table is an illustration of the 
specific element format. Appendix A contains 
detailed discussion of the pack catalog and central 
catalog formats. 
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Table 2-1 . Name Element Format 





2 


Standard Control Bytes 


4 




Next Name Element 




6 








8 




Previous Name 


Element 


10 


Name Length 






12 




File Name and Qualifier 


36 




Number of Pointers 


38 


Pointer Identification 






40 




Pointer 


42 


Pointer Identification 






44 




Pointe 


r 


46 


Pointer Identification 






48 




Pointe 


r 



Bytes 



1 
2.3 



4-6 



7-9 



10 



Bit 



0,1 



2-5 



6,7 



Description 



Data type (binary) 
01 User data 

1 System data 

1 1 Both user and system data 



Reserved, always OOOO2 



Count of length bytes, always 1 02 



Relative record number within block, with value to m-1 for m records 



Length bytes, giving length of the record (in bytes) with the measurement being exclusive of the control bytes 



Thread to the next name element (in collating sequence). This thread is expressed in a BBR format, where BB 
is the relative block number (value 1 to n for n blocks) and R is the relative record number (value to m-1 for 
the next name element's position within block BB. BBR=0 for the thread in the last name element of the chain. 



Thread to the previous name element within the catalog file. BBR=0 for the first name element of the chain. 



Name length, giving the count of bytes in the File Name and Qualifier field. The total count must 
be even and not exceed 26. 
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Table 2-1. Name Element Format (Continued) 



Bytes 



Bit 



Description 



11-36 



File Name and Qualifier, containing a file name consisting of a maximum of 17 EBCDIC characters (alphabetic, 
numeric, and dash), a period separator, and a qualifier consisting of a maximum of eight alphanumeric charac- 
ters. For name elements related to a system catalog file, the EBCDIC requirement is lifted. 



37 



Number of element pointers which follow within the name element. 



38,42. 
46 



Pointer identification, expressed in hexadecimal within one byte and identifying the pointer, where * denotes 
pertinent name elements within an entry in the pack catalog, and ** denotes pertinent name elements within 
an entry in the central catalog. Other pointers are pertinent in both the pack and central catalogs. 



00 

10 

20* 

30** 

40** 

41** 

50 

51 

60* 

61* 

70** 

71** 

80** 



81' 



Null pointer 

Pointer to attribute element 

Pointer to space element 

Pointer to volume element 

Pointer (from the indexed file's name element) to the name element of the information file 

Pointer (from the information file's name element) to the name element of the indexed file 

Pointer (from the lower paired file's name element) to the name element of the upper file 

Pointer (from the upper paired file's name element) to the name element of the lower file 

System pointer (from the pack catalog name element describing the pack catalog) to the 
chain of available entry blocks within the pack catalog 

System pointer (from the pack catalog name element describing the pack catalog) to the 
chain of available continuation blocks within the pack catalog 

System pointer (from the central catalog name element describing the central catalog) to 
the chain of available entry blocks within the central catalog 

System pointer (from the central catalog name element describing the central catalog) to 
the chain of available continuation blocks within the central catalog 

System pointer (from the name element of a SYSIN or subordinate scratch or temporary 
file) to the name element of the next chronologically sequenced scratch or temporary file. 
Scratch or temporary files are cataloged like any other file, in that they are entered by 
collating sequence into the main chain of existing files. In addition, the scratch or temporary 
file is linked in a secondary chain to the pertinent SYSIN entry through use of the forward 
system pointer (identification of 80) and backward pointer (identification of 81). 

System pointer (from the name element of a scratch or temporary file) to the name element 
of previous scratch or temporary file or to the SYSIN entry at the front of the secondary 
chain 



39-41, 
43-45, 
47-49 



Pointers (in BBR format) to the pertinent elements previously described. 
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Table 2-2. Attribute Element Format 





2 

4 

6 

8 

10 

12 

14 

16 

18 
20 
22 
24 
26 
28 



Standard Control Bytes 



PF PI WV 



FT 



Key Size 



FO 



CF CD CC 



Spread 



Block Size 



Record Length 



Relative Key Position 



Highest Block Written 



Reserved 



Modification Security Code 



Offset 



Byte 


Bit 


Description 


0-3 




Control bytes (defined in Table 2-1 ) 


4 





Paired file flag. If PF=1 , file is paired 


1 


Paired index (PI) 








Upper file 








1 Lower file 




2 


Write verify (WV) 








No write verify 








1 Write verify 




3,4 


File type (FT) 








00 Permanent 








01 Scratch 








10 Temporary 








1 1 Work 




5-7 


File organization (FO) 








000 General 








001 Indexed 
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Table 2-2. Attribute Element Format (continued) 



Byte 


Bit 


Description 






010 Relative 

100 Sequential 

1 1 1 Information (for indexed file) 


5 


1 


Central catalog (CF) 

File is uncataloged 

1 File is cataloged 


2 


Common stored data format (CD) 

Not common stored data format 

1 Common stored data format 


3 


Control character (CC) 

ANSI control characters 

1 Native device control characters 


4-7 


Spread factor for indexed files (SPREAD) 


6,7 




Block size (in bytes) of data block 


8,9 




Record length (in bytes) of a record within a data block 


10,11 




Relative key position; pointer to the primary key in the data portion of a record. Position refers to the first 
byte following the control bytes. 


12 




Key size (in bytes) of the primary key 


13-15 




Highest block written, relative block number for the last block written in the file 


16-21 




Reserved 


22-25 




Modification security code 


26-29 




Offset; lower limit of relative record number at the time a relative file is created or, for a sequential file, the 
relative block number for the first block of the highest volume written. In the information file's attribute 
element for an indexed file, the first two bytes have the count of directory blocks that have been allocated. 
The other two bytes have the count of index blocks. 
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Table 2-3. Space Element and Space Element Continuation Format 





2 

4 

6 

8 

10 

12 

14 

16 

18 

20 

22 

24 



LV 



CE 



Standard Control Bytes 



Continuation of Space Element 



CB 



ifiiiiiifiiiiiiiii 

Iiii u i ! 



Segment Count 



Segment Sequence Number 



Track Address 



Track Count 



*One per segment 



tOne per segment 



Space Element 




2 


Standard Control Bytes 


4 








Continuation of Space Element 


6 






8 








Previous Sp« 


ice Element 


10 


LV 


CE 


CB jllllll 






12 






Segment Sequence Number 


14 


Track Address 


16 


Track Count 



Space Element Continuation 
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Table 2-3. Space Element and Space Element Continuation Format (Continued) 



Byte 


Bit 


Description 


0-3 




Control bytes (defined in Table 2-1) 


4-6 




Continuation of space element, a thread (in BBR format) which points to the next space element continuation 
for a file 


7-9* 




Previous space element is a thread (in BBR format) which points to the previous space element. 


10 





If LV=1 , this is the last volume for a file 


1 


If CE=1, a space element continuation exists 


2 


If CB = 1, each segment lower boundary is on a cylinder boundary 


11-17; 

11* 




Not used 


18,19 




Segment count, a count of space elements used by the file on this volume 


20,21 ; 
12,13* 




Segment sequence number, giving relative segment number for each segment (shows relation to segments 
existing on same or separate volumes) 


22,23; 
14,15* 




Track address relative to beginning of segment. (All physical disc addresses are expressed in terms of track 
number rather than cylinder and track within a cylinder.) 


24,25; 
16,17* 




Track count of tracks in segment 



*Byte position(s) unique to space element continuation table. 
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Table 2-4. Volume Element and Volume Element Continuation Format 




2 


Standard Control Bytes 


4 




Continuation of Volume Element 




6 




MD 


CE | 


8 


Segment Count 


10 


Volume Count 


12 
14 

16 


Volume Serial Number 


18 




File Name Entry in Pack Catalog 




20 




Device Type 


22 


HW 


■'■ ■: : 


Reserved 



•One per volume 



Volume Element 





2 

4 

6 

8 

10 

12 

14 

16 

18 



Standard Control Bytes 




Continuation of Volume Element 






MD 


CE 




Volume Serial Number 




File Name Entry i 


n Pack Catalog 






Device Type 


HW 




Reserved 



tOne per volume 



Volume Element Continuation 
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Table 2-4. Volume Element and Volume Element Continuation Format (Continued) 



Byte 


Bit 


Description 


0-3 




Control bytes (defined in Table 2-1) 


4-6 




Continuation of volume element, a thread (in BBR format) which points to the next volume element continuation 
for a file 


7 





Modified volume descriptions. If MD=1 , central catalog is created and modified volume descriptions are 
included. 


1 


If CE=1, volume element continuation exists 


8.9 




Segment count 


10,11 




Volume count 


12-17; 
8-13* 




Volume serial number 


18-20; 
14-16* 




File entry in pack catalog, a pointer to the file's entry in the specified volume's pack catalog (BBR format) 


21.-17* 




Device type (00 16 for MEMOREX 3664 Drive) 


22;18* 





If HW=1, highest volume written 


23;19* 




Reserved 



"Byte position (s) unique to volume element continuation table. 
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TABLES 

Tables are primarily for storage information that is 
easily referenced. The Data Management system has 
two primary tables for information reference: 

• File Description Table (FDT) created by 
OPEN 

• Buffer Description Table (BDT) created by 
DEFSF, DEFRF.orDEFIF 



FILE DESCRIPTION TABLE 

A File Description Table (FDT) is built dynamically 
during a job's execution time in the user area of 
memory. An OPEN request causes an FDT to be 
built, and a CLOSE request releases the FDT space. 
The FDT is 60 bytes in length. The portion of the 
FDT common to all files is 40 bytes in length, and 
the remainder of the FDT which is device dependent 
is 20 bytes in length. 



BUFFER DESCRIPTION TABLE 

A Buffer Description Table (BDT) is created by the 
file definition macros (DEFSF, DEFRF, and DEFIF). 
This main-memory table is used by the GET/PUT 
logic to manage buffers and control logical records. 
The BDT is responsible for recording location of I/O 
buffer(s) and record areas. 



A BDT is created for each file organization: 
sequential, relative, indexed. The three BDT format 
tables follow with the appropriate field descriptions 
(Tables 2-9 through 2-11). 



The FDT is linked with block I/O requests through an 
8-byte identification field; the identification field in 
the FDT and the block I/O request must match. The 
FDT contains a unit table ordinal through which I/O 
control routines find the unit table and execute the 
I/O request. Parameters in the FDT protect users 
from overlapping each other's area on a shared device. 
Table 2-5 gives the locations of the different 
information fields of the FDT. Tables 2-6 through 2-8 
give the device-dependent fields of the FDT. 
Manipulation of FDT's in the user partition is 
discussed in Control Language Services, Extended 
Reference. 
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Table 2-5. File Description Table Format 



Byte 



-10,-9 
-8,-7 



-6 



-5,-4,-3 



■2,-1 



-10 
-8 
-6 
-4 
-2 

2 
4 



Reserved 



LOA 



OB 



Label Ordinal 



PFL 



NFL 



UB 



FRE 



NC 



Identification 



10 
12 
14 
16 
18 
20 
22 
24 
26 
28 
30 



! c 



us 



UD 



SF 



Current Block Number 



ERP 



END 



FR 



BB 



Block Size 



Current CW Pointer 



Status 



RC 



Device Dependent Fields* 



*Refer to appropriate device table (Tables 2-6 through 2-8). 



Bit 



Description 



Reserved 



Length (in bytes) of FDT (LOA) 



Device Type 



Last Block I/O Function 



Return Code 



Tag for CW 



Ordinal bit (OB) 

Label ordinal points to central catalog 

1 Label ordinal points to Control Language job file 



Label ordinal indicates the position of the label in the central catalog or the Control Language Job file. 



Previous FDT address (PFL) 
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Byte 



0.1 



4-11 



12 



13 



14-17 



18 



19 



Bit 



0-7 



2,3 



0-7 



Table 2-5. File Description Table Format (Continued) 



Description 



Next FDT address (NFL) 



User bit (UB) reserved for emulator set to zero when FDT is built 



Freeze flag (FRE) 

File is not frozen 

1 File is reserved for a recycle of outstanding queue entry block (QEB) 



Native character set flag (NC). If N01 . first data byte is the command code. 



Device type 



File identification 



Common stored data format bit (C) 

Not common stored data format 

1 Common stored data format 



Usage flag (US) 

00 Input 

01 Update 
10 Output 



Bypass flag (B) 

No bypass 

1 Bypass, READ goes to EOF and WRITE is a NOP 



Update flag (UD) 

No update 

1 Update 



Lockout flag (L) 

No lockout 

1 Close with lock 



Sequential file (SF) 

Not sequential 

1 Sequential 



Last function processed in block I/O 



Block number after last function processed. If zero, current block number is unknown. 



End condition bit (END) indicates the sensing of an end condition: EOF, EOA, or printer carriage channels 
9 or 12. 



Return code 



2-14 



Byte 



20 



21 



22,23 



24,25 



26,27 



28,29 



Bit 



Table 2-5. File Description Table Format (Continued) 



Description 



Error recovery processing flag (ERP) 

Call error recovery when errors encountered 

1 Do not call error recovery for errors 



FDT restore (FR) 

FDT not restored 

1 FDT restored 



Hold up flag (H) 

File not in recovery 

1 File in error recovery and following requests are held up until recovery complete 



Block I/O internal flag (BB); set by block I/O to indicate that a RESET macro has passed through the file. 
Bit is reset by driver. 



Tag for command word (CW) address pointer 



Byte size lor maximum size) of each record 



A pointer to the current or last CW executed by this file 



Status of last I/O operation 



Residual count (RC): the difference between bytes requested and bytes received 



The device dependent portion of the FDT begins at byte 30. 
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Table 2-6. Disc Device Format 



30 


Res. 


PF 


PA 


WF 


DF 


Reserved 


Number of Residual Blocks 


32 

34 


Highest Block Written 


36 
38 


Relative Block Number 


40 








Blks/Track 


r 


Gap 


42 


Next Segment Link 


44 








UORD 


Number of Conti 




Reserved 


46 










juous Tracks 




48 


Beginning Track Number 



'Extent 



Byte 


Bit 


Description 


30 





Reserved 


1 


Paired file flag (PF) 

Not paired 

1 Paired file 


2 


Paired file indicator (PA) 

Upper portion of track used for this file 

1 Lower portion of track used for this file 


3 


Write check flag (WF) 

No write check 

1 Write check of all writes 


4 


Disc driver flag (DF) 


5-7 


Reserved 


31 




Residual block number, the number of blocks remaining to be up for a multiblock read request which crosses 
tracks 


32-35 




Highest block number written for volume now mounted 


36-39 




Relative block number (calculated from beginning of file) of first block on presently mounted volume 


40 


0-5 


Number of records on a disc track (BLK/TRACK) 


40,41 


6-7, 
0-7 


Gap in bytes between records for pack rotational speed variation 


42-43 




Next segment link (extent address) 
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Table 2-6. Disc Device Format (Continued) 



Byte 


Bit 


Description 


44 




Unit table ordinal (UORD) which indicates the unit table to which this segment is related 


45 




Reserved 


46,47 




Number of contiguous tracks 


48,49 




Beginning track number for this extent (0-3999) 
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Table 2-7. Magnetic Tape Device Format 



30 
32 
34 
36 

38 
40 
42 
44 
46 
48 



Sense 


Relative Block Number 


: ; : ; : ^ ■ : : - / : 


.v^-lif^^^^SI^ :; 








" '■'''%': 


UORD 


ALT ORD 


Volume Number 


LP 


TM 




o 


■ : : -,. ■:-;; : : ■ : 


■: : : 











Byte 


Bit 


Description 


30-35 




Sense bytes of the unit at the time of the last error 


36-39 




Relative block number (calculated from beginning of file) of first block on presently mounted volume 


44 




Current unit table ordinal (UORD) 


45 




Unit ordinal of alternate tape (ALT ORD) 


46 




Volume number 


47 





Label processing flag (LP) 

No label processing complete 

1 Label processing complete 


1 


Tape mark flag (TM); a tape mark precedes the first data record on the tape 


7 


Offset (O), an alternate unit 
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Table 2-8. Unit Record Device Format 



30 


Sense 


UORD 


32 




^:i::::S:-:^:S:iii:-:':::':-Si' 
: : : :^: : : : :^: : S! : : ; :l: ; : ; :v: : ! ; : : : : ; 

Plftlflliil 
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lllllllllllll 
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48 






fllliiiili 


W$M$$$$ 


> : : : :*: : : : :;i''i;:W: : : : :v: : : : : 


iillllllllll: 






. 



Byte 



30 



31 



Bit 



Description 



Sense byte of the unit at the time of last error 



Unit table ordinal (UORD) 
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Table 2-9. Buffer Description Table Format for Sequential Files 




2 
4 
6 
8 
10 
12 



NB 



FTYP 



LABL 



GET/PUT Address 



AM 



S TAG GP MOD 



RT 



Block Size 



Record Size 



Record Area Address 



Blocking Factor 



S TAG RA 



File Identification 



18 
20 

22 
24 
26 
28 
30 
32 
34 
36 
38 
40 
42 
44 
46 



Save Area Address 



Error Offset 



S TAG SA 



Record Address Pointer 



Relative Record Number 



Current Block Number 



S TAG RAP 



PU 



AB 



UR 



Logical Record Number 

1 — 



SK IG 



Use 



Work Area 



54 



Move Routine 
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Tabla 2-9. Bmffer Description Table Format for Sequential Files (Continued) 



56 



66 
68 



88 
90 



110 
112 
114 



Block I/O Packet 



Buffer 1 I/O Packet 



Buffer 2 I/O Packet 



Error Address 



S TAG EA 



Byte 



0,1 



•Optional 

If buffer 2 is absent, bytes 90 through 93 end the BDT as follows: 



90 
92 



Bit 



1,2 



4,5 



Error Address 



Description 



External address of the GET/PUT module processing this file 



Number of buffers (NB) 

One buffer 

1 Two buffers 



File type (FTYP) 

00 Sequential 

01 Relative 
10 Indexed 



s TAP FA 



Shared buffer flag (S). If S-1, I/O buffers are shared with other files. 



Label processing (LABL) 
00 No labels 
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Table 2-9. Buffer Description Table Format for Sequential Files (Continued) 



Byte 


Bit 


Description 






01 Nonstandard labels 
10 Standard labels 


6 


Access method (AM) 

Sequential 

1 Random 


7 


Record type (RT) 

Fixed length 

1 Variable length 


3 




Blocking factor, number of records per block (0-255) 


4,5 




Block size (in bytes) of the I/O buffer(s), size must include record headers 


6,7 




Record size (in bytes) of maximum record excluding header 


8 




Segment tag for GET/PUT module (S TAG GP MOD) 


9 




Segment tag for record area address (S TAG RA) 


10,11 




Record area address, first byte of record area 


12-19 




File identifier for data file (8 bytes EBCDIC) 


21 




Segment tag for save area address (S TAG SA) 


22,23 




Save area address, calling program's linkage and register save area 


24,25 




Error offset, offset (in bytes) to error address from beginning of BDT 


27 




Segment tag for record address pointer (S TAG RAP) 


28,29 




Record address pointer, first byte address of active record in active I/O data buffer 


30-33 




Relative record number, record number relative to first record in the file 


34-37 




Current block number, physical block number present in active buffer 


38-39 




Logical record number, number of active record in active buffer 


40 





If PU-1, the record address pointer has been updated following a PUT or reset to the first record in the active 
buffer. 


1 


Active buffer (AB) 

First buffer 

1 Second buffer 


2 


PUT flag (P). If P=1, record has been written in the active data buffer. 


3 


Unit record flag (UR). If UR=1 , device is not disc or tape. 
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Table 2-9. Buffer Description Table Format for Sequential Files (Continued) 



Byte 


Bit 


Description 




5 


Limits flag (L). If L=1 , Iimit6 are defined for relative files 


6 


I/O register flag (II 

Record area 

1 I/O register 


7 


Verify flag (V). If V=1 , write verify is performed. 


41 





Skip flag (SK). If SK=1, error option is to skip error. 


1 


Ignore flag (IG). If IG=1, ignore option was selection. 


2 


Binary bit (B). If B=1, binary cards are to be read. 


6,7 


I/O usage (USE) 

00 Input 

01 Update 
10 Output 


42-45 




Work area 


46-55 




Move routine. Data movement routine consisting of a MOVL instruction followed by a BR instruction. 


56-67 




Block I/O packet used to issue service requests such as CLOVE, POSITION, and RESET. 


68-69 




Buffer I/O packet for I/O between the data file and the first I/O buffer. 


90-111* 




Buffer 2 I/O packet for I/O between the data file and the second I/O buffer. (Optional) 


113\91t 




Segment tag for error address (S TAG EA) 


114-115*; 
92-93t 




Error address, address of error return 



*Byte positions unique to BDT for sequential files when buffer 2 is present. 
tByte positions unique to BDT for sequential file when buffer 2 is absent. 
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Table 2-10. Suffer Description Table Format for Relative Files 










GET/PUT Address 






2 


NB 


FTYP 


S 


LABL 


AM 


RT 


Blocking Factor 


4 


Block Size 


6 


Record Size 


8 


S TAG GP MOD 


S TAG RA 


10 


Record Area Address 


12 






File Identification 






18 












20 




S TAG SA 


22 









Save Area Address 






24 






Error Offset 






26 


W-V--"f^<-: ^--: :: ^ ■ ■:'<■ --R ^ *M: :: '. 


S TAG RAP 


28 






Record Address Pointer 






30 












32 






Relative Record Number 






34 












36 






Current Block Number 






38 




Logical Record Number 


40 


PU 


AB 


P 


UR 




L 


1 


V 


SK 


IG 


B 






llllll 


Use 


42 












44 






Work Area 






46 












r 


-1 




Move Routine 




T 


54 












56 












r 


J> 




Block I/O Packet 




T 


66 












68 












r 






Buffer 1 I/O Packet 






88 
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Table 2-10. Buffer Description Table Format for Relative Files (Continued) 



*r 



110 
112 
114 
116 
118 
120 
122 
124 
126 
128 
130 



Buffer 2 I/O Packet 



Key Address Pointer 



Limit X 



Limit Y 



Offset 



Error Address 



S TAG AK 



S TAG EA 



"Optional 



If buffer 2 is absent, bytes 90 through 109 end the BDT as follows: 



90 

92 

94 

96 

98 

100 

102 

104 

106 

108 



™p«™: 



Key Address Pointer 



Limit X 



Limit Y 



Offset 



Error Address 



S TAG AK 



S TAG EA 



•Optional 
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Table 2-10. Buffer Description Table Format for Relative Files (Continued) 



Byte 



Bit 



Description 



0,1 



1,2 



External address of the GET/PUT module processing this file 



Number of buffers (NBI 

One buffer 

1 Two buffers 



File Type IFTYP) 

00 Sequential 

01 Relative 
10 Indexed 



Shared buffer flag (S). If S=1, I/O buffers are shared with other files. 



4,5 Label processing (LABLI 

00 No labels 

01 Nonstandard labels 
10 Standard labels 



Access Method (AM) 

Sequential 

1 Random 

Record type (RT) 

Fixed length 

1 Variable length 



Blocking factor, number of records per block (0-255) 



4,5 



6,7 



Block size (in bytes) of the I/O buffers, size must include record headers 



Record size (in bytes) of maximum record excluding header 



Segment tag for GET/PUT module (S TAG GP MOD) 



Segment tag for record area address (S TAG RA) 



10,11 



12-19 



Record area address, first byte of record area 



File identifier for data file (8 bytes EBCDIC) 



21 



Segment tag for save area address (S TAG SA) 



22,23 



24,25 



27 



28,29 



Save area address, calling programs linkage and register save area 



Error offset, offset (in bytes) to error address from beginning of BDT 



Segment tag for record address pointer (S TAG RAP) 



Record address pointer, first byte address of active record in active I/O data buffer 



30-33 



Relative record number, record number relative to the first record in the file 
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Table 2-10. Buffer Description Table Format for Relative Files (Continued) 



Byte 


Bit 


Description 


34-37 




Current block number, physical block number present in active buffer 


38-39 




Logical record number, number of active record in active buffer 


40 





If PU=1 , the record address pointer has been updated following a PUT or reset to the first record in the active 
buffer. 


1 


Active buffer (AB) 

First buffer 

1 Second buffer 


2 


PUT flag (P). If P=1 , record has been written in the active data buffer. 


3 


Unit record flag (UR). If UR=1, device is not disc or tape. 


5 


Limits flag (L). If L=1, limits are defined for relative files. 


6 


I/O register flag (I) 

Record area 

1 I/O register 


7 


Verify flag (V). If V=1, write verify is performed. 


41 





Skip flag (SK). If SK=1, error option is to skip error. 


1 


Ignore flag (IG). If IG=1, ignore option was selected. 


2 


Binary bit (B). If B=1, binary cards are to be read. 


6,7 


I/O Usage (USE) 

00 Input 

01 Update 
10 Output 


42-45 




Work Area 


46-55 




Move routine. Data movement routine consisting of a MOVL instruction followed by a BR instruction. 


56-67 




Block I/O packet used to issue service requests such as CLOVE, POSITION, and ADD KEY/DELETE KEYS. 


68-89 




Buffer 1 I/O packet for I/O between the data file and the first I/O buffer. 


90-1 1 1 * 




Buffer 2 I/O packet for I/O between the data file and the second I/O buffer. 


113*,91t 




Segment tag for key address pointer (S TAG AK) 


114,115*; 
92,93t 




Key address pointer. First byte address of key address field for relative file. 
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Table 2-10. Buffer Description Table Format for Rotative Files (Continued) 



Byte 


Bit 


Description 


116-119*; 
94-97t 




Limit X, lower limit for processing. Optional. 


120-123*; 
98-1 01 1 




Limit Y, upper limit for processing. Optional. 


124-127*; 
102-1 05t 




Offset, lower limits defined when file was first created. Optional. 


129*;107t 




Segment tag for Error Address (S TAG EA) 


130,131*; 
108,109t 




Error address. Address of error return. 



*Byte positions unique to BDT for relative files when buffer 2 is present. 
tByte positions unique to BDT for relative files when buffer 2 is absent. 
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Table 2-11. Buffer Description Table Format for Indexed Files 




2 
4 
6 
8 
10 
12 



NB 



GET/PUT Address 



FTYP 



LABL 



STAG GPMOD 



AM 



RT 



Block Size 



Record Size 



Record Area Address 



Blocking Factor 



S TAG RA 



File Identification 



18 
20 
22 
24 
26 
28 
3Q 

32 

34 
36 
38 
40 
42 
44 

46 

?i 
54 
56 

66 
68 

/- i 

88 



PU 



AB 



EOF 



IS 



Save Area Address 



Error Offset 



Relative Address Pointer 



Relative Record Number 



Current Block Number 1 



Logical Record Number 



IF 



IG 



Work Area 



Move Routine 



Block I/O Packet 



Buffer 1 I/O Packet 



S TAG SA 



S TAG RAP 



PG 



IW 



Use 



J 
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Table 2-11. Buffer Description Table Format for Indexed Files (Continued) 



90 

r 
r 

110 

112 
114 
116 
118 
120 
122 
124 
126 
128 
130 
132 
134 
136 

* 

144 
146 
148 
150 

f 

r 

170 

172 
174 
176 
178 

180 
182 



Key Size 



Index Buffer I/O Packet 



S TAG AK 



KEYADR1 Address Pointer 



Index Buffer Block 



Current Index Block 



STAGIKP 



Index Block Key Address Pointer 



Directory to the Directory Block Address 



Number of Directory Blocks 



Physical Block Number 



Compare Routine 



iliipil! 



S TAG FK 



KEYADR2 Address Pointer 



Buffer 2 I/O Packet 



Current Block Number 2 



STAGHLDB 



Directory to the Directory Block Pointer 



S TAG EA 



Error Address 



I 



•Optional 



If buffer 2 is absent, bytes 1 50 through 1 57 end the BDT as shown: 
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'Optional 



Table 2-11. Buffer Description Table Format for Indexed Files (Continued) 



150 




STAG HLDB 


152 


Directory to the Directory Block Pointer 


154 




S TAG EA 


156 


Error Address 



Byte 



Bit 



Description 



0,1 



External address of the GET/PUT module processing this file 



Number of buffers (NB) 

One buffer 

1 Two buffers 



1,2 



File type (FTYP) 

00 Sequential 

01 Relative 
10 Indexed 



Shared buffer flag (S). If S=1 , I/O buffers are shared with other files. 



4,5 



Label processing (l.ABL) 

00 No labels 

01 Nonstandard labels 
10 Standard labels 



Access method (AM) 

Sequential 

1 Random 



Record type (RT) 

Fixed length 

1 Variable length 



Blocking factor, number of records per block (0-255) 



4,5 



Block size (in bytes) of the I/O buffer(s), size must include record headers 



6,7 



Record size (in bytes) of maximum record excluding header 



Segment tag for GET/PUT module (S TAG GP MOD) 



Segment tag for record area address (S TAG RA) 



10,11 



Record area address, first byte of record area 



12-19 



File identifier for data file and information file (8 bytes, EBCDIC) 
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Table 2-11. Buffer Description Table Format for Indexed File (Continued) 



Byte 
20 


Bit 


Description 




Spread factor (K-|), indicating how many passes made on each track 


21 




Segment tag for save area address (S TAG SA) 


22,23 




Save area address, calling program's linkage and register save area 


24.25 




Error offset, offset (in bytes) to error address from beginning of BDT 


26 




Number of blocks per track minus one (K2) 


27 




Segment tag for record address pointer (S TAG RAP) 


28,29 




Record address pointer, first byte address of active record in active I/O data buffer 


30-33 




Relative record number, record number relative to the first record in the file 


34-37 




Current block number 1, physical block number present in data buffer 1 


40 





If PU=1, the index block key address pointer was updated by a DELR, PUT, or PUTU instruction in sequential 
access mode. 


1 


Active buffer (AB) 

First buffer 

1 Second buffer 


2 


PUT flag (P). If P=1 . record has been written in the active data buffer 


3 


End-of-file flag (EOF). If EOF=1, the end-of-file has been reached. 


4 


Index sharing flag (IS). If IS—I. index buffer is shared with data buffer. 


5 


Index file flag (IF) If IF=1, index block was just read or written. 


6 


I/O register flag (I) 

Record area 

1 I/O register 


7 


Verify flag (V). If V=1 , write verify is performed. 


41 


1 


Ignore flag (IG). If IG=1, ignore option was selected. 


3 


Previous GET flag (PG). If PG=1 , last operation was a GET. 


4 


Index write flag (IWI. If IW=1. KEY is added or deleted in current index block. 


6,7 


I/O usage (USE) 

00 Input 

01 Update 
10 Output 


42-45 




Work Area 


46-55 




Move routine. Data movement routine consisting of a MOVL followed by a BR instruction. 
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Table 2-11. Buffer Description Table Format for Indexed Files (Continued) 



Byte 


Bit 


Description 


56-67 




Block I/O packet, used to issue service requests such as CLOVE, POSITION, and ADD KEY/DELETE KEYS. 


68-89 




Buffer 1 I/O packet for I/O between the data file and the first I/O buffer. 


90-111 




Index buffer I/O packet. I/O parameter packet for I/O between the information file and the index buffer. 


112 




Number of blocks per pass minus one (K3). 


113 




Segment tag for key address 1 pointer (S TAG AK) 


114,115 




Key address 1 (KEYADR1) pointer, first byte address of key address 1 field 


116 




Current pass boundary counter (C-|) 


117 




Current track boundary counter (C2) 


118,119 




Index buffer size, in bytes 


120-123 




Current index block number; physical block number present in index buffer. 


124 




Key size, size (in bytes) of primary key field 


125 




Segment tag for index block key address pointer (S TAG IKP) 


126,127 




Index block key address pointer, first byte address of active key in index buffer 


128,129 




Block address of directory to the directory block 


130,131 




Number of directory blocks written 


132-135 




Physical block number of data block to be read or written 


136-145 




Compare routine, data comparison consisting of a CMPX instruction followed by a BR instruction. 


146 





KEYADR2flag<F) 

KEYADR2 not present 

1 KEYADR2 present 


1 


Directory to the directory block flag (D) 

Directory to the directory block in mass storage 

1 Directory to the directory block in main storage 


147* 




Segment tag for key address 2 (KEYADR2) pointer (S TAG FK) 


148,149* 




Key address 2 (KEYADR2) pointer 


150-171* 




Buffer 2 I/O packet, parameter packet for I/O between data file and second I/O buffer 


172-175* 




Current block number 2, physical block number present in data buffer 2 


177*;151t 




Segment tag for directory to the directory block pointer (S TAG HLDB) 


178,179*; 
152,1 531- 




Directory to the directory block pointer, first byte address of main storage directory to the directory block 
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Table 2-11. Buffer Description Table Format for Indexed Files (Continued) 



Byte 


Bit 


Description 


181*;155t 




Segment tag for Error Address (S TAG EA) 


182,183*; 
156,157t 




Error address, address of error return 



"Byte positions unique to BDT for indexed files when buffer 2 is present. 
tByte positions unique to BDT for indexed files when buffer 2 is absent. 
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3. BLOCK INPUT/OUTPUT 



INTRODUCTION 

The block level of input/output processing may be 
applied either to files which were previously 
processed at the logical level* or to files intended for 
use at the block level only. But whatever the 
organization of the file being processed, the data is 
referenced by key block number or as next data 
block for the unit record devices. 



The basic unit of data transfer at the block (and 
physical) level is the block. Thus the 
block-input/output user may only read or write a 
whole block of data at a time (not individual records 
within a block). 

If the user is operating on files created specifically for 
block input/output use, he is free to establish within 
the blocks any arrangement or grouping of logical 
records he wishes, and the blocking and deblocking of 
these records must of course be performed by the 
user himself. However, it should be noted that if he 
wishes to operate on previously-created files which 
were used for logical input/output, he must be aware 
of the pre-established logical structure of the data 
within the blocks. 



GENERAL RULES 

Tape and disc files for block input/output processing 
are created in the same way as those created for 
logical input/output (that is, through Control 
Language //DEF statements external to the program 
or ALLOC macros internally). These are standard 
system file structures and the following rules of file 
logic must be observed when processing them: 

• A file must be opened before it may be 
processed 

• All blocks within a given disc file must be of 
the same length 

• Blocks must be at least two bytes long for 
disc requests (printer and card punch 
requests are two bytes long). 

• Block numbers may go from 1 to 232-1 (disc 
block is 224-1) 

• All buffers must begin on word boundaries 
for disc 

• Read buffers will terminate on word 
boundaries for disc 

In addition, the following restrictions should be 
noted: 



•Sequential and relative files may easily be processed by 
block input/output but it is not practical to apply block 
input/output to indexed files. 



• Processing across volume boundaries on 
sequential files is not allowed without calling 
CLOVE 

• Multi-block reading will only be 
implemented for files with blocks of an even 
byte length 

• Key fields are not supported for disc storage 
and will be ignored if present 
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BLOCK INPUT/OUTPUT CODING 



BLOCK READING 



A set of system macro instructions is provided for 
block input/output coding. The basic macros are 
READ, WRITE, POSITN and CNTRL. With these 
instructions blocks of data may be read and written, 
files may be positioned to particular blocks in 
preparation for processing, and certain hardware 
commands not involving data transfer may be 
performed. Other facilities that might be required are 
provided by the STATUS macro, which allows file 
status checking; the TYPE macro, which returns 
device type; and the RESET macro, which enables 
error conditions to be cleared (to allow for 
continuation after an error). 



A particular block of data within a file is referred to 
by number. All files are ordered sequentially, with 
the first block of the file being block number 1. As an 
aid to processing files in a sequential manner, explicit 
block numbers are not necessary. Any data request 
with an implied block number causes the block 
number to be updated. The block referred to by a 
request is determined relative to an internal block 
number maintained by the I/O control routines. 



The READ macro reads a block of data from a 
specified file and stores it at a specified buffer 
address. The number of the block to be read is 
obtained either directly from the READ call (if 
specified) or by adding 1 to the current block count 
saved by the system. After the READ is executed the 
updated block number will replace the old block 
number in the file's block counter so that a 
subsequent READ will automatically read the next 
block. 

If a POSITN macro (to the same file) is executed 
immediately preceding a READ, the current block 
number will be used without change. When a file is 
opened for input (reading) its block counter is 
initially set at 1. 

BLOCK WRITING 

The WRITE macro transfers a block of data from a 
specified buffer address to a specified file. The 
number of the block into which the data is to be 
written is obtained either directly from the WRITE 
call (if specified) or by adding 1 to the current block 



Table 3-1 . Assumed Block Numbers 



Operational Sequence 



Effect 



READ 
READ 
READ 



Disc: 



All: 



Each Read causes a one-count increase in the block number 
before the operation. 

Records are read sequentially. 




Disc: 



All: 



Each Write causes a one-count increase in the block number 
after the operation. 

Records are written sequentially. 



POSITN POSITN 

READ I WRITE I 




The block referred to by Positn is used for the Read or Write request. 



Disc: 



The block written replaces the block just read. 



Reader/Punch: The block is written into the card just read (file open for update) ; 
and the block is written into the next card (file open for output). 



Mag Tape: 



The block is written after the block just read. 




Disc: 



The block number is increased after the WRITE operation and 
not prior to the Read operation. This avoids skipping the next 
sequential block. 



Reader/Punch: Card n is written. Card n+1 is then read. 
Mag Tape: Invalid sequence. 
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count saved by the system. After the WRITE is 
executed the updated block number will replace the 
old block number in the file's block counter so that a 
subsequent WRITE will automatically write into the 
next block. 

If a POSITN macro (to the same file) is executed 
immediately preceding the WRITE the current block 
number will be used without change. 

If a READ macro immediately precedes a WRITE, 
the current block number will be increased by 1 in 
the normal way for a magnetic tape file but will not 
be altered in the case of a disc file. 



When a file is opened for output (writing), what 
happens to the block counter depends on the type of 
file. For scratch, temporary and work files, opening 
the file sets the block counter to 1. For permanent 
files, however, the block counter will not be altered 
and will retain the value left in it on the previous use. 
This enables data already contained on the file to be 
saved between different job runs by adding new data 
only to the end of the file (unless otherwise 
specified). 



Table 3-1 gives the assumed block numbers for the 
READ, WRITE, and POSITN macros. 



BLOCK POSITIONING 

The current block number of a file may be preset by 
a POSITN macro for subsequent reading or writing. 
This macro sets the current block counter of a 
specified file to a specified value. 



PROCESSING CONSIDERATIONS 

REQUEST OVERLAP 

Multiple requests to the same file or the same device 
can be issued. However, to avoid ambiguous results, 
separate request blocks and data buffers must be 
used. Requests will be honored in the order of receipt 
within a file. Issuing multiple requests, with the aid of 
the RETURN=YES operand in the requesting macros, 
improves throughput by enabling the system to 
overlap input/output set-up time with data 
transmission. 

PRIORITY 

Input/output requests are processed by the system 
according to the priority of the program which issues 
them. This priority is specified in the Control 
Language //JOB card and is set at the time the job is 

initiated. 

END CONDITIONS 

End conditions are special boundary conditions 
resulting in return indications to the user but not 
considered as errors. 

• End of File (EOF) 

EOF is a logical boundary defined for input 
files. Each device* capable of reading has a 
defined end of file condition. EOF provides 
a condition in the data stream which is 
uniquely detectable by the system. After 
EOF has been detected on disc, magnetic 
tape, or the card reader, a RESET macro 
must be issued before processing may 
continue. 



DEVICE CONTROL COMMANDS 

Input/output device control commands, not involving 
a data transfer, may be implemented by the CNTRL 
macro. This macro transmits a specified command to 
the device containing a specified file. Typical 
commands transmitted by this macro are Skip to Top 
of Form for line printer, Rewind Tape for tape drive. 



On the card readert, a data record beginning 
with the characters /* is defined to be an 
end-of-file condition. When EOF is detected, 
the entire record will be transferred to the 
user's buffer. 



On magnetic tape the EOF condition is set 
whenever a tapemark is detected. 



SPACE MANAGEMENT AND FILE CONTROL 

Space management and file control for block 
input/output are handled by Data Management 
functions described in Section 2. For space 
management ALLOC, EXPAND and PURGE are 
used. For file control OPEN, CLOSE and CLOVE are 
used. 



* An exception to this is the card reader where the /* card is 
used to indicate the EOR condition in the EBCDIC mode. 
In the EBCDIC=NO mode, there is no EOF condition 
detectable by an I/O driver because all data images are 
considered to be legal data. 

tThe operator-selected EOF option on IBM card readers is 
not supported. 
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With disc, the EOF condition is set when a 
block with a data-length specification of 
zero has been read. Note that an embedded 
EOF will not be detected, however, during a 
multi-block read. 

• End of Allocation (EOA) 

EOA is a physical boundary applying only to 
disc output files. An EOA indication is 
returned any time a block is written into the 
last allocated space for the file. 

• End of Tape < EOT) 

EOT is a physical boundary applying only to 
magnetic tape output files. It signifies that 
the end-of-tape reflective marker has been 
sensed. 

PROCESSING MULTI-VOLUME FILES 

When processing sequential files occupying more than 
one physical volume (disc and tape only), the block 
input/output user must perform volume switching to 
move from one volume to another. 

At any given time, the File Description Table for a 
sequential file* may only describe a single physical 
volume, which limits the current range of processing 
to the described volume. When, during processing, the 
user encounters an EOV indication or wishes to 
prematurely close the volume and switch to the next 
volume he must issue a CLOVE (close volume) macro 
to continue processing on the next consecutive 
volume. CLOVE ensures that the next volume is 
mounted, by issuing an operator message if necessary, 
and then modifies the FDT to describe the next 
volume. 

If there are no more volumes to be processed, the 
EOF/EOA bit (bit 2 of the return information) in the 
CLOVE packet is set. The user is responsible for 
testing this condition. 

SENSE INFORMATION 

The number of bytes of sense information varies with 
the device. All the bytes for the device are maintained 
in the File Description Table, and are updated 
whenever an abnormal completion occurs for reasons 



other than logical errors. A STATUS macro request 
transfers this information from the File Description 
Table to the user buffer (to the extent that user 
buffer allows). 



REQUEST TERMINATION 

The user requesting a block I/O operation has two 
options while a request is processed: 

• to wait for the request to be completed. 

• to return to do parallel processing after the 
request is recognized and before the request 
is processed to completion. 

If the user elects to wait for the request to be 
completed before continuing with processing, his 
program will be suspended by the operating system 
until the request has been terminated. 

If the user has returned to do parallel processing, the 
COMPLETE indicator in the parameter string is set 
when the request is returned from the I/O control 
routines. 

ERROR PROCESSING 

At the block input/output level, the system 
automatically provides attempted recovery from 
hardware device errors. If peripheral device error 
recovery is successful, control is returned to the user 
with no error indication. 

In the case of an error return (where peripheral device 
error recovery has been unable to correct the error), 
the program (and the rest of the job) normally is 
aborted. However, if ERRCOMP=YES is coded in the 
request macro, control is returned to the user 
together with return information (Appendix C) thus 
enabling him to process the error condition himself. 
It should be noted that before issuing another request 
to the same file following an error return, the user 
may first have to reset the error condition with a 
RESET macro (Appendix C). 

Examples of block input/output are shown in Figures 
3-1 and 3-2. 



* An FDT for a relative file describes the whole file, therefore 
eliminating the need for CLOVE in this case. 
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LABEL 


OPER'N 


OPERANDS 


COMMENTS 




OPEN 


IDENT=CARDIN,IOTYP=B,USAGE=l 


OPEN CARD INPUT FILE 




OPEN 


IDENT=PRINT,IOTYP=B,USAGE=0 


OPEN PRINTER OUTPUT FILE 


START 


READ 


IDENT=CARDIN,OATABUF=CRDIMG 


READ A CARD 




TBIT 


2,START+4 


CHECK FOR END-OF-FILE IN REQ BLOCK 




BOV 


END 


IF EOF. GO CLOSE FILES AND END PROGRAM 




WRITE 


IDENT=PRINT,DATABUF=CRDBUF 


PRINT CONTENT OF A CARD 




B 


START 


GO READ ANOTHER CARD 


END 


CLOSE 


IDENT=CARDIN,IOTYP=B 


CLOSE CARD FILE 




CLOSE 


IDENT=PRINT,IOTYP=B 


CLOSE PRINTER FILE 




HALT 




TERMINATE PROGRAM 


* * * # 


****** 


****** DATA AREA * * * * * 


****************** 


CRDBUF 


WRS 


80 


CARD/PRINT BUFFER 


CARDIN 


WDD 


C'CARDIN ' 


CARD FILE IDENT 


PRINT 


WOD 


C'PRINT ' 


PRINTER FILE IDENT 



Figure 3-1 . Block I/O Program to Read Cards and Print 
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> 


C END 
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NO 
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MOVE ONE 

CARD IMAGE 

FROM DISC BUFFER 

TO PRINT LINE 

(INDEXED) 








INCREASE COUNT, 

DISC BUFFER 

INDEX 






< 


' 








PRINT 
CARD IMAGE 
















NO >T Dl 

^L BUF 


SC ^S,^ 




' 


' 






FER ^S 

LL ^^ 




INCREASE COUNT, 

DISC BUFFER 

INDEX 








^*S_ FU 






^ 


YES 

r 






< 










WRITE 

BUFFER 

TO DISC 

(ONE BLOCK) 




NO ^/" Dl 


SC ^"S. 
FER ^ 

YES 






^wEM 





















Figure 3-2. Block I/O Program to Read Cards into Disc File 
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LABEL 


OPER'N 


OPERANDS 


COMMENTS 




OPEN 


IDENT=CFIL,IOTYP=B,USAGE=l 


OPEN CARD FILE 




OPEN 


IDENT=DFIL,IOTYP=B.USAGE=0 


OPEN DISC FILE FOR OUTPUT 




OPEN 


IDENT=PFIL,IOTYP=B,USAGE=0 


OPEN PRINTER FILE 


START 


LODI 


3,0 


ZERO DISC BUFFER INDEX 


CARDRD 


READ 


IDENT=CFIL,BUFADR=CBUF 


READ A CARD 




MOVX 


DBUF(80,3),CBUF(80) 


MOVE CARD IMAGE TO DISC BUFFER 




TBIT 


2.CARDRD+4 


CHECK FOR END-OF-FILE 




BOV 


RESET 


IF EOF, GO READ DISC FILE 




ADDD 


3,80 


INCREMENT BUFFER INDEX 




CMPD 


3,800 


CHECK IF BUFFER FULL 




BNE 


CARDRD 


IF NOT, GO READ ANOTHER CARD 


DISCWR 


WRITE 


IDENT=DFIL,BUFADR=DBUF,RETURN=YES 


WRITE 10-CARD BUFFER ON DISC FILE 




B 


START 


GO READ ANOTHER 10 CARDS 


RESET 


CLOSE 


IDENT=DFIL,IOTYP=B 


CLOSE DISC FILE 




OPEN 


IDENT=DFIL,IOTYP=B,USAGE=l 


REOPEN DISC FILE FOR INPUT 


DISCRD 


READ 


IIDENT=DFIL,BUFADR-DBUF 


READ A BLOCK FROM DISC 




TBIT 


2.DISCRD+4 


CHECK FOR END-OF-FILE 




BOV 


END 


IF EOF, GO END PROGRAM 




LODI 


3,0 


ZERO DISC BUFFER INDEX 




MOVX 


PBUF(80),DBUF(80, 3) 


MOVE CARD IMAGE FROM DISC BUFFER TO PRINT 
LINE 


PRINT 


WRITE 


iriENT=PFIL,BUFADR=PBUF 


PRINT A CARD IMAGE 




ADDD 


3,80 


INCREMENT DISC BUFFER INDEX 




CMPD 


3,800 


CHECK IF BUFFER HAS BEEN EMPTIED 




BNE 


PRINT 


IF NOT, GO PRINT ANOTHER CARD IMAGE 




B 


DISCRD 


GO READ ANOTHER BLOCK FROM DISC FILE 


END 


CLOSE 


IDENT=CFIL,IOTYP=B 


CLOSE CARD FILE 




CLOSE 


IDENT=DFIL,IOTYP=B 


CLOSE DISC FILE 




CLOSE 


IDENT=PFIL,IOTYP=B 


CLOSE PRINTER FILE 




HALT 




TERMINATE PROGRAM 


# * # X 


* * * * # ■> 


****** DATA AREA ****** 


* # 


CBUF 


WRS 


80 


CARD BUFFER 


DBUF 


WRS 


800 


DISC BUFFER 


PBUF 


WRS 


80 


PRINTLINE 


CFIL 


WDD 


C'CFIL 


CARD FILE IDENT 


PFIL 


WDD 


C'PFIL 


PRINTER FILE IDENT 


DFIL 


WDD 


C'DFIL 


DISC FILE IDENT 



Figure 3-2. Block I/O Program to Read Cards into Disc File (Continued) 
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4. PHYSICAL INPUT/OUTPUT 



INTRODUCTION 

The physical I/O interface gives the user ability to 
utilize the device drivers to perform 
hardware-dependent I/O operations. 

Physical input/output is independent of the system's 
file processing scheme. Whereas block input/output 
deals with files, physical input/output deals directly 
with hardware devices. Use of physical I/O assumes 
the following: 

• Devices to be used must be defined by 
Control Language //DEF statements 



Devices must be opened for 
transmission (by the OPEN macro) 



data 



Error recovery will automatically be 
provided by the system (but may be 
bypassed if desired) 



PHYSICAL INPUT/OUTPUT CODING 

DEFINING AND OPENING DEVICES 

Each device to be used for a physical input/output 
operation must first be assigned by the system. This is 
done through a System Control Language //DEF 
statement. An OPEN macro must also be coded in the 
user program to return the assigned unit ordinal used 
in building the PCB (next paragraph). 

PERFORMING THE PHYSICAL I/O OPERATION 

To perform a physical I/O operation, three entities 
must be created in the user's program: 

• a command program 

• a physical command block (PCB) 

• a "do I/O" instruction (EXCP) 

The command program does not consist of directly 
executable codes but is a chain of "command words" 
which will be operated on by the system's I/O 
processing routines. The program should be located in 
a data area of the program and may be built by means 
of COMMAND macros. 



Examples of command word functions are these: 

• print a record on a line printer 

• select a stacker on a card reader 

• seek on a disc file 

• read a card record from a card reader 

For every physical input/output operation a Physical 
Control Block (PCB) is required. The PCB should be 
located in a data area. The Physical Control Block 
may be build by a PCB macro. 

To initiate the execution of physical I/O command 
programs a single action macro, EXCP, is required; it 
must be coded in line with the program's executable 
code. While the above general requirements are fixed, 
there are several variations in the detailed 
implementation, some of which allow more efficient 
use of memory space than others. Efficient use of 
device may be another consideration for not doing 
this. First the basic method will be explained, and 
then the more efficient methods will be described. 
Basic Method 

In the simplest situation, there is one PCB for each 
command program and one EXCP for each PCB 
(Figure 4-1 ). In this case, the address of the command 
program may be assembled into the PCB by the 
CPADR operand in the PCB macro, and the address 
of the PCB may be assembled (by means of the PCB 
operand) into the corresponding EXCP macro. 

Sharing a PCB 

When there are several command programs applying 
to the same device, coding efficiency may be 
improved by having these command programs all 
share the same PCB (Figure 4-2). In this case the 
address of the appropriate command program must 
be dynamically supplied to the PCB before each 
operation. This may be done by supplying the 
appropriate command program address through the 
related EXCP (by means of the CP operand) rather 
than by presetting it into the PCB. Thus a group of 
EXCP's may all specify the same PCB but different 
command programs. Input/output operations to 
different devices may be overlapped by coding 
RETURN=YES in the appropriate EXCP instruction. 
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Figure 4-1. Basic Method for Physical I/O 



EXCP 




EXCP 




EXCP 


























' 


t ^ 


' ' 


f 






PCB 




















i 


r 






1 


' 






" 


CP 




CP 




CP 



Figure 4-2. Sharing a PCB 
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Figure 4-3. Sharing an EXCP 
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Sharing an EXCP 



command block (PCB): 



Sometimes it is possible to employ a single EXCP to 
operate through a PCB on several command programs 
or even to operate on several PCB's (Figure 4-3). 
When this is to be done, the user may set up a table 
of command program addresses (and PCB addresses, 
if there are multiple PCB's). The EXCP will then refer 
to the address tables at execution time by indirect 
addressing with the CPADR operand and PCBADR 
operand. 

OVERLAPPED OPERATION* 

There is a PCB for each input/output device; 
input/output operations to different devices may be 
overlapped by coding RETURN=YES in the relevant 
EXCP instruction(s). This causes control to be 
retained by the requesting program (while the I/O 
operation itself is concurrently being processed by 
the system), thus enabling initiation of another I/O 
operation before the first has been completed. 

Beyond this, it is also possible to overlap requests to 
the same device, but it should be remembered that a 
separate PCB and data buffer will be required for 
each such overlapped request. When multiple requests 
are issued in this manner, throughput will be 
improved since the system is able to overlap I/O 
set-up time with data transmission. (The system will 
always service multiple requests to the same device in 
order of receipt.) 

PHYSICAL REQUEST TERMINATION 

When a physical I/O request is completed, several 
values are returned to the calling program in the 



• address of the last command word executed 
or attempted to be executed 

• hardware status indication 

• residual byte count of last data operation 
PHYSICAL I/O RESTRICTIONS 

• Byte count must be less than 2 1 6 -1 (65K) 

• Multi-record read operations must not 
attempt access to records across track 
boundaries (disc). 

• The user is responsible for validating a "read 
count field" request (disc). 

ERROR PROCESSING 

System error recovery (Appendix C) is provided by 
default just as it is at the block level. However, at the 
physical level, system error recovery may be bypassed 
by coding ERROPT=NO in the PCB macro. In any 
case, an uncorrected error will always cause the 
program to be aborted unless the operand 
ERRCOMP=YES is coded in the EXCP macro making 
the request. When ERRCOMP=YES is used, control is 
returned to the user in the event of an error, together 
with return information in the PCB so the user may 
either ignore it or process the error himself. 

EXAMPLE OF PHYSICAL I/O PROGRAM 

Figure 4-4 shows a block diagram of a program to 
read cards and print. A coding form illustrates the 
code necessary for this physical I/O program. 



The effectiveness of overlapped coding is dependent on 
the number of Queue Entry Blocks available in the 
system, a SYSGEN variable. 
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Figure 4-4. Physical I/O Program to Read Cards and Print 
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5. CONTROL PROGRAM SERVICES 



INTRODUCTION 

The executive services are those implemented directly 
by the Control Program itself to assist the user in 
various areas, such as input/output request control 
and communication between job steps. 

SERVICE REQUEST CONTROL 

Control over the issuance of service requests by the 
user program may be aided by the WAIT, INFORM 
and DELAY* macros. In one way or another, all of 
these macros can detect completion of the user's 
service requests. 

WAIT simply suspends program execution until 
completion of the specified request or requests. 
WAIT is used to wait for any one or all of the 
outstanding service requests. 

DELAY enables the user to suspend execution for a 
specific period of time with the option of breaking 
the delay (resuming execution) on the completion of 
any service request. 

INFORM offers the capability of detecting the 
completion of a service request in the interval 
between the issuances of the INFORM and its actual 
processing by the system. This capability, which is 
not available with the WAIT macros, is implemented 
with the aid of a user-supplied count of the number 
of outstanding requests he has at the time of issuing 
the INFORM. By comparing this count with its own 
count of outstanding requests, the system can 
determine whether any requests had been completed 
in the time since INFORM was issued by the user. In 
addition to this, INFORM always returns control 
immediately to the user (it has an implied 
RETURN=YES operand) so that he may continue 
processing and subsequently check completion of the 
INFORM by testing the complete bit in the request 
block. 

INTER STEP AND CONTROL LANGUAGE 
COMMUNICATION 

User programs running as separate job steps in a 



multi-step job have two ways of transferring data to 
one another: The POST/RPOST pair of macrost and 
the SETCOM/GETCOM pair of macros. 

In addition, any program may influence the 
subsequent course of the job by means of the SETIF 
macro which posts information to be tested by an 
//I F statement between later job steps. 

The POST/RPOST pair of macros post and read a 
single byte of data in the Job Control Table, whereas 
the SETCOM/GETCOM pair post and read a full eight 
bytes. 

FINDING PARTITION SIZE 

When a program is being written which is expected to 
run in partitions of various sizes, it would often be 
advantageous to code the program in such a way as to 
occupy as much of the partition as is currently 
available. 



To achieve this flexibility, a dynamic determination 
of current partition size is necessary; this is provided 
by the M EM LI M macro. 

MEMLIM informs the program of the size of the user" 
portion of the partition in which it is currently 
running by returning the starting address of the last 
addressable 256-byte page, expressed as an absolute 
address. In effect, MEMLIM returns the starting 
address of the last usable page below the partition 
space pool. For this reason, programs which make use 
of MEMLIM should always specify a fixed-length 
space pool through the appropriate Link Editor 
directive, since otherwise the space pool will 
automatically commence on the page boundary 
following the space allocated to the program. 



*DELAY is not available on the minimal system. 
tPOST/RPOST conform to the IBM UPSI bit scheme. 
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READING DATA FROM //PAR CARDS 

Data may be read from //PAR cards supplied in the 
job control deck by means of the ACCEPT macro. 
This macro transfers the contents of a single //PAR 
card into a specified buffer. On the first execution of 
ACCEPT, the first //PAR card is read; successive 
executions automatically read the rest of the //PAR 
cards consecutively. After the last //PAR card has 
been read the next execution of an ACCEPT transfers 
program control to a specified "end" address. 
The user may also specify a particular //PAR card by 
using the PARNUM keyword in the ACCEPT macro. 



WRITING TO THE SYSOUT FILE 

SYSOUT files are system output files, one of which is 
created uniquely for each job*. Any user program 
may write a one-line EBCDIC message on the 
SYSOUT file for the job by means of the DISPLAY 
macro. The location of the message buffer should be 
specified on the related DISPLAY macro call. 
DISPLAY expands to in-line processing code, 
including an embedded block I/O WRITE to the 
SYSOUT file. 



*The Control Language Services Reference manuals contain 
further explanations. 
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6. INTERACTION OF DATA MANAGEMENT 
AND THE CONTROL LANGUAGE 



Through the //DEFINE statement, a run-time 
interaction between certain Data Management 
services and Control Language services is provided. 
This interaction gives the program independence from 
reassembling to make changes that can then be made 
at run-time through the control language statements. 

Both the logical I/O level (described in Control 
Program and Data Management Services, Basic 
Reference) and the block I/O level require space 
management. Users of the physical I/O level require 
no space management. The Control Language and/or 
the space management macros (ALLOC, EXPND, and 
PURGE) can allocate, expand, or purge files. 

If the Control Language is externally allocating a file, 
the parameters are passed to the ALLOC packet by 
the Step Initiator. A file is allocated by either the 
ALLOC macro or by the //DEFINE statement, not 
both. The ALLOC macro uses the FILENAME, MSC, 
and VOLUME parameters specified in the //DEFINE 
statement to override the parameter packet at 
execution time. 



A space management routine is called in response to a 
service request from either the Control Language 
processor or the user program. The Control Language 
request for Allocate or Expand may be generated at 
step initiation time using parameters given in the 
//DEFINE statement. The Control Language request 
for Purge may be generated at step termination time, 
using parameters given in the pertinent files disc 
catalog entry. The user program request for Allocate, 
Expand, or Purge is generated at assembly time, using 
parameters given as keyword in a macro call. The user 
request may optionally make reference to 
FILENAME, MSC, and VOLUME information given 
in a //DEFINE statement. If so, at execution time, 
the FILENAME and MSC parameters in the 
//DEFINE statement override the equivalent 
parameters contained in the user request. 
Table 6-1 summarizes the use of different Control 
Language parameters as used by the Step Initiator, 
OPEN, CLOVE, ALLOC, EXPND, and PURGE. 
Further explanations of the Control Language can be 
found in Control Language Services, Extended 
Reference. 
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Table 6-1 . Summary of Data Management and Control Language Interaction 



Control Language 


Control Language 






ALLOC, EXPND, 


Keyword Parameter 


Step Initiator 


OPEN Macro 


CLOVE Macro 


PURGE Macros 


IDENTIFIER 


Not used 


Must match file 


Must match file 


Must match file identifier 






identifier in 


identifier in 


in macro. 






OPEN macro. 


CLOVE macro. 




FILENAME 


Used to search 


Override DEFLB 


Override DEFLB 


Override DEFLB informa- 




central catalog to 


information. 


information. 


tion. 




determine volumes 










of a cataloged file. 








STATUS 


File usage checked 
for partition conflicts. 
File type passed to 
ALLOCATE packet* 
if NUMBER is 
specified. 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


MSC 


Not used by Step 


Override DEFLB 


Override DEFLB 


Override DEFLB informa- 




Initiator 


information. 


information. 


tion. 


DEVICE 


Used to allocate 
peripheral re- 
sources to files. 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


VOLUME 


Used to mount 


When volumes have 


Used to mount and 


Volume identifiers specify 


(and IVOLUME 


packs or tape reels 


been mounted by 


verify successive 


which packs are to be 


for OPEN) 


when possible and 


Step Initiator, they 


volumes of se- 


used for allocation or 




verify the mount 


are verified by 


quential files. 


expansion. If omitted. 




by comparison of 


comparison with 




shared resources are 




volume with volume 


unit table volume 




used. PURGE uses 




identifier in the 


identifier entries. 




volume identifiers for 




volume label. 


When not mounted, 
OPEN mounts the 
volume(s) and 
verifies against 
volume label. 




purging uncataloged files. 


SPREAD 


Passed to the 
ALLOCATE packet* 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


CONTIGUOUS 


Passed to the 
ALLOCATE packet* 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


LABEL 


Not used by Step 


Indicates type of 


Indicates type of 


Not used by ALLOC, 




Initiator 


label processing 
for the job. Con- 
trol Language 
overrides program 
specification. 


label processing 
for the job. Con- 
trol Language 
overrides program 
specification. 


EXPND, or PURGE 


CSD 


Used to compute 
block size from 
SIZE and BLOCK 
for ALLOCATE 
when NUMBER is 
specified. 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


NUMBER 


Used to compute 
number of blocks 
from BLOCK and 
NUMBER for 
ALLOCATE 
Also indicates 
need of ALLOC. 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 



'Parameters are passed to the ALLOCATE parameter packet by the Step Initiator; the Control Langu- qe is allocating 
the file. 
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Table 6-1. Summary of Data Management and Control Language Interaction (Continued) 



Control Language 


Control Language 






ALLOC, EXPND, 


Keyword Parameter 


Step Initiator 


OPEN Macro 


CLOVE Macro 


PURGE Macros 


SIZE 


Used to compute 
block size. Key 
size portion is 
passed to the 
ALLOCATE 
packet* for 
indexed files. 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


BLOCK 


Used to compute 


For tape files. 


Not used by CLOVE 


Not used by ALLOC, 




block size for data 


Control Language 




EXPND, or PURGE 




and index files. 


supplies block size. 
Default value is 
251 bytes. 






LOCATION 


Passed to the 
ALLOCATE 
packet* when 
NUMBER is 
specified. 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


ORGANIZA- 


Passed to the 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 


TION 


ALLOCATE 
packet* 






EXPND, or PURGE 


RETENTION 


Not used by Step 


Used to generate 


Used to generate 


Not used by ALLOC, 




Initiator 


an expiration date 
for tape files. 


an expiration date 
for tape files. 


EXPND, or PURGE 


CATALOG 


Passed to the 
ALLOCATE 
packet* 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 


VERIFY 


Passed to the 


If the file was 


Not used by CLOVE 


Not used by ALLOC, 




ALLOCATE 


cataloged with 




EXPND, or PURGE 




packet* 


VERIFY=YES, 
OPEN does not 
interpret the param- 
eter. If not, then 
VERIFY-YESat 
OPEN time will 
temporarily over- 
ride the catalog 
attribute. 






EXPAND 


Passed to the 
EXPAND packet 


Not used by OPEN 


Not used by CLOVE 


Not used by ALLOC, 
EXPND, or PURGE 



•Parameters are passed to the ALLOCATE parameter packet by the Step Initiator; the Control Language is allocating the file. 
**Parameter is passed to the EXPAND parameter packet by the Step Initiator; the Control Language is expanding the file. 
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7. MACROS 



This section gives the specifications for the block and 
physical I/O level functions of Data Management, 
Block I/O action. Physical I/O action, and Control 
Program Services. In general, all the macros have the 
following format: 



Name 



Operation 



Operand 



The name field is an optional field which contains a 
1- to 8-character alphanumeric file address. The first 
six characters must be unique to accommodate the 
standard suffixes used by the system. These are 
discussed in Appendix B of this manual. The names 
ident, labadr, and tag are used as identifiers for the 
software function specified in the operation field of 
the macro prototype. 

The operand field contains keyword parameters 
which may be in any order separated by commas. 
Optional parameters are denoted by brackets, [ ] . 
Parameters with a choice of specifications are 
denoted by braces, { } , and the default value is 
underlined. 

Fields are free-form and are separated by blanks; 
thus, no imbedded blanks are allowed within the 
parameter string. If more than one card is necessary, a 
semicolon must appear after the last parameter on 
each card except the last. 

Symbolic address (as used in macro prototypes) is the 
1- to 8-character symbol used to identify a coding 
statement. The IDENT parameter is the symbolic 
address of the 8-byte field containing the file 
identifier (left-justified, blank filled). If the pertinent 
file is defined in the Control Language, the file 
identifier referenced by IDENT must be identical to 
the IDENT specified by the //DEFINE statement. 
Unless otherwise stated numbers are assumed to be in 
decimal with no leading zeros. 



DATA MANAGEMENT 

In this section only the block and physical I/O level 
of Data Management macros are given. This level of 
macros include these: 



• Block I/O Level Declarative Macro 

DEFLB 

• Space Management Macros 

ALLOC 
EXPND 
PURGE 

• File Control Macros 

OPEN 

CLOSE 

CLOVE 

• I/O Service Macro 

LABRTN 

• Block I/O Macros 

READ 

WRITE 

POSITN 

CNTRL 

STATUS 

TYPE 

RESET 

• Physical I/O Macros 

EXCP 
PCB 

• Control Program Macros 

WAIT 

DELAY 

INFORM 

POST- 

RPOST 

SETCOM 

GETCOM 

ACCEPT 

DISPLAY 

MEMLIM 

SETIF 

HALT 

EHALT 

ABEND 

TIME 

SDATE 

JDATE 

• Console Communication Macros 

CONSOLE 
MESSAGE 
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Appendix B details the service request mechanism 
and details the expansion of these macros. 

BLOCK I/O LEVEL DECLARATIVE MACRO 

A block I/O level declarative macro, DEFLB, defines 
the file label for Data Management. 

DEFLB - Define File Label 

The DEFLB macro generates file label data into a 
main-memory buffer for creating and checking disc 
file names. The Control Language may also be used to 
create and check file names. The block I/O level space 
management and file control macros use DEFLB. The 
format is as follows: 



Name Operation 


Operand 


labadr DEFLB 


FILENAM=name 




[MSC=code] 


FILENAM=name 





Specifies a 1- to 17-character alphanumeric file name. 
The first character may be A-Z, 0-9, or $; A-Z, 0-9, 
and dash are allowed as succeeding characters. Index 
file names are created internally by adding an asterisk 
at the end of the associated data file name. 



MSC=code 



(Optional) 



Designates a 4-byte EBCDIC modification security 
code, which is used for work and permanent files. If 
omitted, blanks are assumed. 



BLOCK I/O LEVEL AND PHYSICAL I/O LEVEL 
EXECUTIVE REQUESTS 

The executive request macros generate requests for 
space management, file control, file processing, and 
file positioning at the block I/O level. These requests 
specify a file identifier and a specific block of data 
within the file. The file control and file processing 
macros are also available at the physical I/O level, 
specifying a unit identifier rather than a file 
identifier. 

Files which are open for block I/O level file 
processing requests are described by a File 
Description Table (FDT) created by OPEN. FDT 
contains a physical description of the file, a 1- to 
8-character file identifier, and current processing 
information about the file (for example, current 
block number and status of last request). File 
processing and positioning requests are made by file 
identifiers and controlled by the FDT. 

Units which are open for physical I/O level processing 
are assigned by the Control Language. The identifier 
field in OPEN is used to find the correct Control 



Language entry which gives the unit assignment. The 
//DEFINE statement indicates physical I/O by stating 
PIO in the file name field. Physical I/O requests are 
made by a unit ordinal which has been returned to 
the user after an OPEN. 

Space Management Macros 

The ALLOC, EXPND, and PURGE macros manage 
space for all disc files. Usually these three functions 
are generated through the Control Language and by a 
space management utility program, which allows 
changes without recompilation of the program; 
however, a user program can directly manage file 
space. 

The allocation of paired files must be done through a 
utility if not done directly from a user program. The 
utility programs may also purge permanent and work 
files if not done directly from the user program. 

Space management is required for usage of block I/O 
level and logical I/O level interfaces. Users of physical 
I/O level require no space management. 

Space is allocated in increments of tracks. Paired file 
allocation of two files provides minimum arm 
movement for file processing. A contiguous or 
non-contiguous segment of space is allocated to both 
files starting at the chosen segment. Alternate tracks 
from this space are then assigned to each of the two 
files. File space allocated will be contiguous unless 
contiguous space is unavailable, in which case up to 
12 segments will be allocated. Other allocation 
options are as follows: 

• Multipack files (up to seven packs) 

• Suppression of automatic segmentation 

• Cylinder number specification 

Each disc pack contains a volume label which is 
created at disc initialization time. A MRX/OS utility 
program may change the volume label and its 
parameters. 

In its device label each disc pack contains pack status 
indication of one of the following conditions. 



Pa ck Status 
Nonrestricted 

Restricted 
Locked 



Meaning 

Any allocation request may 
obtain space from this pack. 

Only allocation requests with 
packs specified by the Con- 
trol Language may obtain 
space from this pack. 

No further allocation is 
allowed on this pack. 
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Some disc drives are classified as shared resource 
drives at initial program load time. The operator 
mounts a set of packs on these drives, which will be 
available for any allocation requests. The remaining 
disc drives (non-shared-resource drives) are each 
assigned by job control to a specific user partition for 
the job step requesting the drives, and may be used 
only by allocation requests associated with the job 
step in the partition to which they were assigned. 

ALLOC - Allocate Space 

The ALLOC macro allocates space for user data files 
and system data files. When volume identifiers have 
not been specified through job control, space will be 
allocated on nonrestricted packs mounted on shared 
resource drives. When volume identifiers have been 
specified through job control, the disc drives on 
which they are mounted will have been assigned by 
job control to the partition (or system function) of 
the program calling ALLOC. Duplicate file names are 
not allowed on the disc catalogs. The format is as 
follows: 



Name 



[tag] 



Operation 
ALLOC 



Operand 



BLKSIZ=n 
CATALOG-!^ 






a 



CON= { 
- »NO 



[■ 



DATACYL= 



?0 

[errcomp={^ 8 }] 

[FILEORG=code] 
FILESIZ=n 
[FILETYP=code] 
[IDEMT=symbolic address] 

[ ,ND HP S |] 



INDSIZ=n* 
KEYSIZ=n* 

LABDEF1=symbolic address 
[LABDEF2=symbolic address] 
r /YES | 

L lis Hno 

RECSIZ=n 






\ RETURN 



: {YEsn 

' NO IJ 
[SPREAD=n] * 

VEnlFV -(NO S |] 



[ 



•For indexed files only. 



BLKSIZ=n 



Designates the number of 8-bit bytes per block for 
the file. The value n ranges from 18 bytes through 
32 K bytes for magnetic tape and 7294 bytes for disc. 



CATALOG-^} 



(Optional) 



CATALOG=NO specifies that the file should not be 
centrally cataloged. If omitted or CATALOG=YES, 
the file is cataloged. The parameter is ignored for 
scratch and temporary files. 

JYESI 
|NO j 



CON= 



(Optional) 



CON=YES specifies that contiguous space is to be 
obtained. Absence of this parameter or CON=NO 
allows segmentation. 



<*°= \W] 



(Optional) 



CSD=YES (default case) specifies that the file will be 
created with the common stored data format. 
CSD=NO specifies that a data format other than CSD 
will be used. 



(YES 
DATACYL=|NO 
In 



(Optional) 



DATACYL=n designates a cylinder number boundary 
for the beginning of the data file. The value n ranges 
from 1 to 199. DATACYL=YES ensures the file 
beginning on some cylinder boundary; whereas 
DATACYL=NO does not. If the parameter is 
omitted, the data file will not necessarily begin on a 
cylinder boundary. 



ERRCOMP=j^ S ) 



(Optional) 



ERRCOMP=YES specifies that the caller of the 
request will examine return information on nonfatal 
errors; therefore, nonfatal errors should not be 
aborted by the system. Fatal errors such as illegal 
instructions, irrecoverable memory parity errors, 
privilege violations, and bound errors cause an 
unconditional abort. If ERRCOMP=NO or is omitted, 
no return information is examined. 



FILEORG=code 



(Optional) 



Determines the file organization. The possible codes 
are as follows: 

Code Organization 



S 

R 
I 



Sequential 

Relative 

Indexed 



If the code is omitted, sequential file organization is 
used. 
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FILESIZ=n 



LABDEF2=symbolic address 



(Optional) 



Indicates an estimate of the number of blocks 
expected in the data file. 



FILETYP=code 



(Optional) 



Designates the file type. The possible codes are as 
follows: 



Code 



Type 



s 


Scratch 


T 


Temporary 


W 


Work 


P 


Permanent 



If the code is omitted, the temporary file type is 
used. 



IDENT=symbolic address 



(Optional) 



Designates the 8-character file identifier. It should be 
identical to the operand of the IDENTIFIER 
keyword in a Control Language DEFINE statement 
specifying the volume on which to allocate the file. If 
IDENT does not match the IDENTIFIER 
specification (or if omitted) and the file is to be 
centrally cataloged, the file will be allocated on 
shared resources. IDENT is required if the LABDEF1 
parameter is not specified. 



YES 
INDCYL=|NO 



(Indexed files only) 



INDCYL=n specifies a cylinder number boundary for 
the beginning of the index file. The value n ranges 
from 1 to 199. INDCYL=YES ensures the file will 
begin on some cylinder boundary; whereas 
INDCYL=NO does not. If the parameter is omitted, 
the index file will not necessarily begin on a cylinder 
boundary. 



INDSIZ=n 



(Indexed files only) 



Specifies the estimated byte size of the index blocks. 
The value of n ranges from 18 bytes to 7294 bytes. 



KEYSIZ=n 



(Indexed files only) 



Gives an estimate of the byte length of the primary 
key for indexed files. The value of n ranges from 2 
bytes to 100 bytes. 

LABDEF1=symbolic address 

Specifies the symbolic address of a file label area 
which must correspond to the symbolic address 
specified as the name field of the DEFLB macro. 
LABDEF1 is required if the IDENT parameter is not 
specified. 



Specifies a second file label address for paired file 
allocation requests. This option is available for 
sequential and relative files only. 



H«l 



(Optional) 



If LIST=YES, only the parameter packet is generated, 
and the RETURN and ERRCOMP options are not 
used. If LIST=NO, only the 2-byte standard executive 
request instruction is generated. Loading of 
general-purpose register 6 (R6) with the address of 
the parameter packet and general-purpose register 7 
(R7) with the save area address prior to issuing the 
macro call is a user responsibility. If the LIST 
parameter is omitted, both the execution request 
instruction and the parameter packet are generated 
following the macro call. Appendix B contains a 
detailed discussion of the LIST parameter. 

RECSIZ=n 

Indicates the length of a logical record in bytes. The 
value n ranges from 18 bytes through 32K bytes for 
magnetic tape and 7294 bytes for disc. If omitted, 
RECSIZ equals BLKSIZ. 



RETURN^ 5 ) 



(Optional) 



RETURN=YES specifies that the processor issuing 
the executive request should be given control 
(reactivated) as soon as the request is queued to its 
destination routine. If RETURN=NO or if the 
parameter is omitted, the calling processor is 
reactivated when the request processing is complete 
or terminates abnormally if ERRCOMP=YES. 



SPREAD=n 



(Indexed files only) 



Specifies the number of physical blocks separating 
two logically consecutive blocks in the indexed data 
file. The number of blocks between logically 
consecutive blocks is one less than the n value whose 
range is 1 through 10. If this parameter is omitted, 
the logically consecutive blocks are adjacent. 



VERIFY =(^ S ) 



(Optional) 



VERIFY=YES specifies read after write verification 
of all writes to this file. If omitted or if 
VERIFY=NO, write verification will not be a 
permanent file characteristic. The VERIFY=YES 
option may be specified as a temporary override 
through logical level file definition macros or through 
Control Language DEFINE statements at file open 
time. 
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EXPND - Add Mass Storage Space 

The EXPND macro obtains additional mass storage 
space for sequential files. The file may be open but 
cannot have input or update usage at the time of the 
EXPND request. The format is as follows: 



Name 
[tag] 



Operation 



EXPND 



CATALOG' 



JYESl 
"NO | 



Operand 
[CATALOG^}) 

[errcomp={^ s }] 

[FILESIZ=n] 

[IDENT=symbolic address] 
LABDEF=symbolic address 

[PA-RED-ft?}] 
[RETURN={^ S }J 



(Optional) 



CATALOG=NO specifies the file is not centrally 
cataloged. If the parameter is omitted or 
CATALOG=YES, the file is centrally cataloged. The 
parameter is ignored for scratch or temporary files. 



H») 



open at the time of expansion, it must match the 
name specified by the I DENT parameter of the OPEN 
macro. If the file is closed, it should match the 
operand of the IDENTIFIER keyword in a Control 
Language DEFINE statement specifying a volume 
identifier for expansion. If IDENT does not match 
the IDENTIFIER specification (or if omitted) and 
the file is centrally cataloged, the expansion will be to 
the shared device. IDENT is required if LABDEF is 
not specified. IDENT may be omitted only for 
cataloged files. 

LABDEF=symbolic address 

Specifies the symbolic address of a file label which 
must be identical to the label address of the DEFLB 
macro. This parameter is required if the IDENT 
parameter is not specified. 



LIST= 



lYESl 

Ino J 



(Optional) 



(Optional) 



If LIST=YES, only the parameter packet is generated, 
and the RETURN and ERRCOMP options are not 
used. If LIST=NO, only the 2-byte standard executive 
request instruction is generated. Loading of R6 with 
the address of the parameter packet and R7 with the 
save area address prior to issuing the macro call is a 
user responsibility. If the LIST parameter is omitted, 
both the executive request instruction and the 
parameter packet are generated following the macro 
call. Appendix B contains a detailed discussion of the 
LIST parameter. 



CON=YES specifies addition of contiguous space. If 
absent or CON=NO, segmentation is allowed within 
the space added. 



ERRCOMP=l YES l 



"|NQ f 



(Optional) 



ERRCOMP=YES specifies that the caller of the 
request will examine return information on nonfatal 
errors; therefore, nonfatal errors should not be 
aborted by the system. Fatal errors such as illegal 
instructions, irrecoverable memory parity errors, 
privilege violations, and bounds errors cause an 
unconditional abort. If ERRCOMP=NO or if omitted, 
no return information is examined. 

FILESIZ=n (Optional) 

Indicates the number of blocks to add to the file. 

IDENT=symbolic address (Optional) 

Specifies the 8-character file identifier. If the file is 



pai HS s ) 



(Optional) 



PAIRED=YES indicates the file is paired. If 
PAIRED=NO or if the parameter is omitted, there is 
no pairing of files. 



RETURN=g S J 



(Optional) 



RETURN=YES specifies that the processor issuing 
the executive request should be given control 
(reactivated) as soon as the request is queued to its 
destination routine. If RETURN=NO or if the 
parameter is omitted, the calling processor is 
reactivated when the request processing is complete 
or terminates abnormally if ERRCOMP=YES. 

PURGE - Release Disc File Space 

The PURGE macro releases the space allocated to a 
disc file. For paired file allocation, both files are 
purged. The format is as follows: 



7-5 



Name 
[tag] 



Operation 



PURGE 



CATALOG' 



(YES 
"(NO 



Operand 
[CATALOG^}] 

[eRRCOMP={^ S | ] 

[IDENT=symbolic address] 
LABDEF=symbolic address 

l pAIRED =l^ s }] 

[RETURN^*}] 



(Optional) 



CATALOG=NO specifies that the file is not centrally 
cataloged. If the parameter is omitted or 
CATALOG=YES, the file is cataloged. The parameter 
is ignored for scratch and temporary files. 



ERRCOMP=j^ S } 



(Optional) 



ERRCOMP=YES specifies that the caller of the 
request will examine return information on nonfatal 
errors; therefore, nonfatal errors should not be 
aborted by the system. Fatal errors such as illegal 
instructions, irrecoverable memory parity errors, 
privilege violations, and bounds errors cause an 
unconditional abort. If ERRCOMP=NO or if omitted, 
no return information is examined. 



IDENT=symbolic address 



(Optional) 



Specifies the 8-character file identifier. It must match 
the operand of the IDENTIFIER keyword in a 
Control Language DEFINE statement specifying the 
volumes of the file purge. IDENT may be omitted 
only for cataloged files. If omitted, Data Management 
finds the file in the central catalog and then locates 
the volumes. 

LABDEF=symbolic address 

Specifies the address of a file label, which must 
correspond to the label address of the DEFLB macro. 
This parameter is required if the IDENT parameter is 
not specified. 



Hno S ) 



(Optional) 



If LIST=YES, only the parameter packet is generated, 
and the RETURN and ERRCOMP options are not 
used. If LIST=NO, only the 2-byte standard executive 
request instruction is generated. Loading of R6 with 
the address of the parameter packet and R7 with the 



save area address prior to issuing the macro call is a 
user responsibility. If the LIST parameter is omitted, 
both the executive request instruction and the 
parameter packet are generated following the macro 
call. Appendix B contains a detailed discussion of the 
LIST parameter. 



pair Hno S 



(Optional) 



PAIRED=YES indicates the file is paired. If the 
parameter is omitted or PAIRED=NO, the file is not 
paired. 



RETURN= 



(YES) 
I NO J 



(Optional) 



RETURN=YES specifies that the processor issuing 
the executive request should be given control 
(reactivated) as soon as the request is queued to its 
destination routine. If RETURN=NO or is omitted, 
the calling processor is reactivated when the request 
processing is complete or terminates abnormally if 
ERRCOMP=YES. 



FILE CONTROL 

The file control macros — OPEN, CLOSE, and 
CLOVE — direct data transmission. OPEN and 
CLOSE control a file or unit at the block or physical 
I/O level. CLOVE performs volume switching at the 
block I/O level. 

OPEN — Open File for Data Transmission 

The OPEN macro makes the file or unit assessible for 
data transmission. The format is as follows: 



Name Operation 

[tag] OPEN 



Operand 

[ BUFADR=symbolic address] 
[CONTROL^,}] 

[errcomp={^ 8 }] 

IDENT=symbolic address 

&°t Y pH p b }] 

[LABDEF=-symbolic address] 
[RETURN-Q] 



[rewind-^ 8 } ] 



USAGE 
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BUFADR=symbolic address 



(Optional) 



Specifies the address of a buffer for use in initiating a 
file. BUFADR is required when USAGEOfor block 
I/O level openings of a relative file. The user generates 
the desired data as dummy data in this buffer prior to 
the OPEN request. The initialization is performed 
only once. BUFADR is required if IOTYP=P. 



identical with the label address name specified in the 
DEFLB macro. This parameter is ignored for files on 
unit record or magnetic tape (tape labels are assigned 
by the control language). For disc files, label 
information may have been specified by Control 
Language DEFINE statements which override 
LABDEF information. For temporary or scratch files, 
the file name is concatenated with the job name. 



o 
2 

4 

6 

8 

10 



Unit ordinal 


Length 


Unit Table Word 1 


Unit Table Word 2 


Volume Id 



CONTROL 



Jans 
"native 



(Optional) 



CONTROL=NATIVE indicates that the control 
characters are native to that particular device. ANSI 
control characters are used if it is omitted or 
CONTROL=ANS. 



ERRCOMP; 



J YES) 
iNO / 



(Optional) 



ERRCOMP=YES specifies that the caller of the 
request will examine return information on nonfatal 
errors; therefore, nonfatal errors should not be 
aborted by the system. Fatal errors such as illegal 
instructions, irrecoverable memory parity errors, 
privilege violations, and bounds errors cause an 
unconditional abort. If ERRORCOMP=NO or is 
omitted, no return information is examined. 



LIST= 



YES 
NO 



(Optional) 



If LIST=YES, only the parameter packet is generated, 
and the RETURN and ERRCOMP options are not 
used. If LIST=NO, only the 2-byte standard executive 
request instruction is generated. Loading of R6 with 
the address of the parameter packet and R7 with the 
save area address prior to issuing the macro call is a 
user responsibility. If the LIST parameter is omitted, 
both the executive request instruction and the 
parameter packet are generated following the macro 
call. Appendix B contains a detailed discussion of the 
LIST parameter. 



RETURN= 



(YES) 
(NO | 



(Optional) 



RETURN=YES specifies that the processor issuing 
the executive request should be given control 
(reactivated) as soon as the request is queued to its 
destination routine. If RETURN=NO or is omitted, 
the calling processor is reactivated when the request 
processing is complete or terminates abnormally if 
ERRCOMP=YES. 



rewind =|n?) 



(Optional) 



I D ENT=sy mbol ic address 

Specifies the 8-character file identifier. IDENT must 
be identical to the operand of the IDENTIFIER 
keyword in a Control Language DEFINE statement. 



IOTYP= 



(Optional) 



Determines the type of I/O. IOTYP=P for physical 
open. IOTYP=B (block open) creates the FDT for 
block I/O. The default value is B. If IOTYP=P, then 
BUFADR must be specified. 



REWIND=NO indicates that no initial rewind of 

magnetic tape files is to be performed. If 

REWIND=YES or is omitted, initial rewind is 
performed. 



USAGE=|U 



(Optional) 



Specifies input (I), update (U), or output (0) 
processing. Update usage is allowed for sequential 
files only if the record type is fixed length and the 
file is assigned to mass storage. The default value is I. 



LABDEF=symbolic address 

Specifies the address of a main-storage buffer that 
contains a file label. The symbolic address should be 



CLOSE — Close File for Data Transmission 

The CLOSE macro removes the availability of the file 
for data transmission. The format is as follows: 
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Name 



[tag] 



Operation 
CLOSE 



ERRCOMP: 



(YES 

(no 



Operand 

[ERRCOMP=Q S }] 
IDENT=symbolic address 
EOTYP-Q] 

[ RETUR H^ S }] 

[rEW. ND -{£?}] 



(Optional) 



ERRCOMP=YES specifies that the caller of the 
request will examine return information on nonfatal 
errors; therefore, nonfatal errors should not be 
aborted by the system. Fatal errors such as illegal 
instructions, irrecoverable memory parity errors, 
privilege violations, and bounds errors cause an 
unconditional abort. If ERRCOMP=NO or is omitted, 
no return information is examined. 

IDENT=symbolic address 

Specifies the 8-character file identifier. It must be 
identical to the one specified in the OPEN macro. 



IOTYP 



-6) 



(Optional) 



Indicates the type of I/O. IOTYP=P for physical 
close. IOTYP=B (block close) releases the FDT. The 
default value is B. 



H~l 



(Optional) 



If LIST=YES, only the parameter packet is generated, 
and the RETURN and ERRCOMP options are not 
used. If LIST=NO, only the 2-byte standard executive 
request instruction is generated. Loading of R6 with 
the address of the parameter packet and R7 with the 
save area address prior to issuing the macro call is a 
user responsibility. If the LIST parameter is omitted, 
both the executive request instruction and the 
parameter packet are generated following the macro 
call. Appendix B contains a detailed discussion of the 
LIST parameter. 



LOCK 



iNO 



YE S| ln . „ 

N0 j (Optional) 



LOCK=YES is used, the FDT is flagged and OPEN 
may not be executed again during the same job; files 
assigned to magnetic tape are unloaded. When this 
parameter is not used or LOCK=NO, the file may be 
reopened from within the same job; files assigned to 
magnetic tape may be rewound. 



RETURN 



YES) 



J YE! 
"(NO 



(Optional) 



RETURN=YES specifies that the processor issuing 
the executive request should be given control 
(reactivated) as soon as the request is queued to its 
destination routine. If RETURN=NO or is omitted, 
the calling processor is reactivated when the request 
processing is complete or terminates abnormally if 
ERRCOMP=YES. 



rew,nd ={n?) 



(Optional) 



REWIND=NO specifies that magnetic tape files are 
not rewound after closing. If the parameter is omitted 
or REWIND=YES, the tapes are rewound/unloaded. 

CLOVE - Close Volume 

The CLOVE macro performs volume switching at the 
block I/O level. It is used for sequential multivolume 
files assigned to tape or disc. A user program may 
close a volume at any time and switch to the next 
sequential volume. CLOVE must be used when a 
switch to the next volume is indicated by either an 
EOF record or an end of space indicator from block 
I/O. 

CLOVE performs header and trailer label processing 
on tapes, alternate unit processing on tapes, and disc 
pack mounting and dismounting (via operator 
control). The format is as follows: 



Name 



[tag] 



Operation 



CLOVE 



ERRCOMP' 



lYESl 
{NO 



Operand 

[ ERRCOMP^ 5 }] 
IDENT=symbolic address 

[ RETURN-^} ] 

(Optional) 



Specifies the disposition of the file. When 



ERRCOMP=YES specifies that the caller of the 
request will examine return information on nonfatal 
errors; therefore, nonfatal errors should not be 
aborted by the system. Fatal errors such as illegal 
instructions, irrecoverable memory parity errors, 
privilege violations, and bounds errors cause an 
unconditional abort. If ERRCOMP=NO or is omitted, 
no return information is examined. 
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IDENT=symbolic address 

Specifies the 8-character file identifier. 

list= |no I 



(Optional) 



If LIST=YES, only the parameter packet is generated, 
and the RETURN and ERRCOMP options are not 
used. If LIST=NO, only the 2-byte standard executive 
request instruction is generated. Loading of R6 with 
the address of the parameter packet and R7 with the 
save area address prior to issuing the macro call is a 
user responsibility. If the LIST parameter is omitted, 
both the executive request instruction and the 
parameter packet are generated following the macro 
call. Appendix B contains a detailed discussion of the 
LIST parameter. 



RETURN= 



(YES) 
JNO J 



(Optional) 



RETURN=YES specifies that the processor issuing 
the executive request should be given control 
(reactivated) as soon as the request is queued to its 
destination routine. If RETURN=NO or if the 
parameter is omitted, the calling processor is 
reactivated when the request processing is complete 
or terminates abnormally if ERRCOMP=YES. 



I/O SERVICE MACRO 



Data Management also has available I/O service 
macros which can report the status information of 
various aspects of the file. 



LABRTN - Return File Label Information 

The LABRTN macro returns the disc catalog 
elements for uncataloged and cataloged files. The file 
may be open or closed. LABRTN searches the FDT 
string in partition first; and if there is no FDT, 
LABRTN then searches the table created by the 
Control Language DEFINE statement. If the IDENT 
is found, then the proper disc file information is 
returned in the buffer specified by the user in 
INFOADR. If a LABRTN macro is issued against a 
nondisc device and the IDENT specification matches 
a Control Language //DEFINE statement for a 
nondisc device, LABRTN returns an error code and 
returns the device type in the first byte of the user 
buffer. The format is as follows: 



Name 



[tag] 



Operation 



Operand 



LABRTN [ ELEMENT= 



NAME \ 

attribute! ] 

ALL I 



[ ERRCOMP^ 8 } ] 

IDENT=symbolic address 
INFOADR=symbolic address 



[ LIST 



'NO ' J 



[ RETURN^ 8 } ] 



I NAME 
ATTRIBUTE 
ALL 



(Optional) 



Specifies that the name element, attribute element, or 
both elements will be returned in the buffer specified 
by INFOADR. If the parameter is omitted, the 
NAME element is returned. If ELEMENT=ALL is 
specified, the name and attribute elements are 
returned respectively. For an indexed file, the data 
portion of the file is returned first and then the index 
portion of the file. 

ERRCOMP=|^q S | (Optional) 

ERRCOMP=YES specifies that the caller of the 
request will examine return information on nonfatal 
errors; therefore, nonfatal errors should not be 
aborted by the system. Fatal errors such as illegal 
instructions, irrecoverable memory parity errors, 
privilege violations, and bounds errors cause an 
unconditional abort. If ERRCOMP=NO or if omitted, 
no return information is examined. 

IDENT=symbolic address 

Specifies the 8-character file identifier which was 
used to open the file. 

INFOADR=symbolic address 

Specifies the address of a main-storage buffer where 
the information is returned. 



-H™1 



(Optional) 



If LIST=YES, only the parameter packet is generated, 
and the RETURN and ERRCOMP options are not 
used. If LIST=NO, only the 2-byte standard executive 
request instruction is generated. Loading of R6 with 
the address of the parameter packet and R7 with the 
save area address prior to issuing the macro call is a 
user responsibility. If the LIST parameter is omitted, 
both the executive request instruction and the 
parameter packet are generated following the macro 
call. Appendix B contains a detailed discussion of the 
LIST parameter. 
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RETURN= 



YES 
NO 



Optional 



RETURN=YES specifies that the processor issuing 
the executive request should be given control 
(reactivated) as soon as the request is queued to its 
destination routine. If RETURN=NO or if the 
parameter is omitted, the calling processor is 
reactivated when the request processing is complete 
or terminates abnormally if ERRCOMP=YES. 

BLOCK INPUT/OUTPUT MACROS 

READ 

This macro transfers a block of data into the specified 
buffer. If the location of the block is not explicitly 
stated in the request, it will be generated by adding 1 
to the block number last obtained (this applies to disc 
and tape files only). If the preceding reference to this 
file involved a WRITE or POSITN request, the 
current block number is used without updating. When 
the BLKNUM keyword is not used, the file is 
addressed in a sequential manner. 

Standard error recovery is provided, with 
irrecoverable errors terminating the operation and 
posting the return code in the request block. 
Attempts to read outside of the portion of the file 
which is currently accessible (current volume) will 
result in an error. 

Name Opa ration Operand 

[tag] READ IDENT=symbolic address 

DATBUF=symbolic address 
[DATSIZ=symbolic address] 

[RETURN^ 8 }] 
[ERRCOMP={^ S }] 

[eBCD,C={^} ] 

[OPER-SSn] 
[BLKNUM=symbolic address] 

[multblH^ 3 }] 



IDENT=symbolic address 

Specifies the address of a storage location containing 
the file identifier — the name by which the file is 
known to the program (as opposed to the external 
catalog name specified through Control Language). 
The file identifier must be eight bytes in length. 



DATBUF=symbolic address 

The address of the data buffer. Requests to disc 



storage must specify a buffer which begins and ends 
on word boundaries even though the data count may 
be odd. 



DATSIZ=symbolic address 



Optional 



An address pointer to the number of bytes in the 
buffer. If this is omitted, the block size defined for 
the file is used as the byte count. The buffer size may 
be up to 65,535 bytes. Any DATSIZ value given 
which is greater than the device record size will result 
in a nonzero residual count returned at the end of the 
operation. 



"H»l 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN= 



YES 
NO 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP= 



YES] 
NO J 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

The following parameters apply to the card reader 
only. 



EBCDIC= 



■m 



Optional 



This determines the type of conversion to be 
performed on the data between card format and 
memory format. If EBCDIC=YES, the translation is 
made in accordance with the defined EBCDIC 
formats. If EBCDIC=NO, the data on the card is 
accepted in a binary format and is transferred to 
storage without modification (card image storage 
format, shown in Figure 7-1). If the parameter is 
omitted the EBCDIC=Y-ES option is assumed. 
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Figure 7-1. Card Image/Storage Relationship 



OPER=SSn 



Optional 



Selects a stacker for the card read, designated by n. 
The value n is determined by the hardware device 
being used. This parameter is ignored except for card 
readers with multiple stackers. If it is omitted, the 
normal stacker is used. 

The following parameter applies to magnetic tape and 
disc files only. 



BLKNUM=address 



Optional 



The address of a four-byte hexadecimal field 
containing the block number to be read. If it is 
omitted, the current block number of the file is 
updated by 1 before the READ, unless the last 
operation was a WRITE* or POSITN, in which case 
the current block number is used. Block numbers up 
to 2-32-1 are allowed, but attempts to read beyond 
the limits of a file (as defined by allocation) are 
returned with return information noted. 



WRITE 

This macro transfers a block of data from the 
specified buffer to an I/O device. The location on the 
I/O device where the data is to be placed may be 
controlled by the BLKNUM keyword (disc), or the 
current setting of the file block number will be used. 
In either case, the file block number is updated after 
the WRITE operation by adding 1 to the current 
block number. 

When writing to the line printer or card punch, the 
first character of the user's buffer is used for carriage 
or stacker control, and is deleted from the data line. 
This feature may be overridden by the OPER option. 
The first character of the buffer is still deleted from 
the line. 

Errors detected by the I/O routines initiate error 
recovery procedures. If these fail to correct the error, 
the return code is posted in the request block and the 
operation is terminated. 



Block numbers up to 2 32 -1 are allowed, but attempts 
to read beyond the limits of a file (as defined by 
allocation) are returned with return information 
noted. 



MULTBLK= 



(YES J 
|NO I 



(Optional) 



If this operand is specified, as many disc records as 
the program buffer will hold will be loaded. Any 
remaining buffer space will be noted in the residual 
count field. 

*READ after WRITE on magnetic tape is illegal. 



Name Operation Operand 

[tag] WRITE IDENT=symbolic address 

DATBUF=symbolic address 
[DATSIZ=symbolic address] 



RETURN 



JYES }1 



Ino 



[ ERRCOMP={^ s } ] 

[BLKNUM=symbolic address] 

{SKnn 
SPnn 
SSn 
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IDENT=symbolic address 

Specifies the address of a storage location containing 
the file identifier - the name by which the file is 
known to the program (as opposed to the external 
catalog name specified through Control Language). 
The file identifier must be eight bytes in length. 

DATBUF=symbolic address 

Specifies the address of the data buffer. Requests to 
disc must specify a buffer which begins a word 
boundary. 



DATSIZ=symbolic address 



Optional 



The address of the memory word which contains the 
byte count of the buffer. If it is omitted, the block 
size defined for the file is used as the byte count. The 
buffer size may be up to 65,535 bytes. 



H») 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN= 



m 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is added, or the default is taken, 
control will only be returned on completion of the 
request. 



Block numbers through 2^2-1 are allowed, but 
attempts to write beyond the limits of a file (as 
defined by allocation) are returned with an error 
indication. 



Line F'rinter 



OPER=SKnn 



Optional 



Defines a carriage control tape channel to be used 
when the data is written by a line printer. If the file is 
not a printer file, the value of nn is converted to a 
comparable ASA standard control character which 
overlays the first character of the written block. If 
the file is a printer file, this parameter overrides the 
carriage operation specified by the first character of 
the data record. Regardless of the method used, the 
first character in the data buffer is deleted from the 
print line. 



OPER=SPnn 



Optional 



Defines the number of print lines to be spaced after 
printing. It is treated in a manner like that of the 
OPER=SKnn parameter. From 1 to 15 lines may be 
specified depending on hardware capabilities. 



Card Punch 



OPER=SSn 



Optional 



Defines a stacker select operation to a card punch. If 
this parameter is used, the first character in the data 
buffer is written in the first position of the card. If 
the parameter is not used, the first character in the 
data buffer is treated as a stacker select code and is 
deleted from the punch data. The absence of multiple 
stackers on the card punch has no effect on this 
procedure. 



EBCDIC= 



./YES 
(NO 



Optional 



ERRCOMP= 



I YES 
(NO 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



Magnetic Tape and Disc 

BLKNUM=symbolic address 



Optional 



The address of a four-byte hexadecimal field 
containing the block number to be read. This 
parameter is valid only for direct-access storage 
devices. If it is omitted, the current block number of 
the file is updated by 1 after the WRITE operation. 



This determines the type of conversion to be 
performed on the data between card format and 
memory format. With EBCDIC=YES, the translation 
is made in accordance with the defined EBCDIC 
formats. With EBCDIC=NO, the data on the card is 
treated as being in a binary format (card image) and is 
transferred from storage without modification 
(Figure 7-1). If the parameter is omitted the 
EBCDIC=YES option is assumed. 



POSITN - Change Current Block Number 

The POSITN request is used to change the current 
block number for the file. The subsequent READ or 
WRITE macro begins processing at the new block 
number. POSITN is only allowed for files assigned to 
disc storage or magnetic tape. 
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A POSITN on a magnetic tape file will always cause 
the tape to be physically repositioned, whereas with 
disc files a physical seek operation will not be 
performed unless explicitly requested by SEEK=YES. 



Name Operation 



[tag] POSITN 



Operand 

IDENT=symbolic address 

{ BOV 
EOV 
symbolic address 

I RETURN '{« S ) ! 

[ERRCOMP-)^ 3 }) 



IDENT=symbolic address 

Specifies the address of a storage location containing 
the file identifier — the name by which the file is 
known to the program (as opposed to the external 
catalog name specified through Control Language). 
The file identifier must be eight bytes in length. 



[BQY ) 

BLKNUM=<EOV 

(symbolic address J 



Optional 



Specifies the block number at which the file is to be 
positioned. BOV indicates beginning of volume, EOV 
indicates end of volume*. If a symbolic address is 
coded this is taken as the address of a four-byte field 
containing the block number as an unsigned 
hexadecimal number. 

If this parameter is omitted, a position to BOV is 
performed. Standard error recovery is provided, with 
irrecoverable errors terminating the operation and 
posting the exception indicator and return code in 
the request block. A POSITN to block number 1 is a 
request to position at the beginning of the file. A 
POSITN to block number will return an error. A 
position to a block number above the highest block 
currently mounted will also be returned with an 
error; however, the file will be left positioned on the 
last block of the volume or file. 



HnT) 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 



"For magnetic tape EOV indicates a position forward to the 
first taper-nark. For disc, BOV and EOV result in 
positioning, across physical pack boundaries if necessary, to 
the lowest (BOV) or highest (EOV) block number which is 
currently described in the File Description Table. 



request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN= 



YESl 
W I 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is added, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP=j^ S ) 



Optional 



To be used when the user devices to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

The following description applies only to disc storage. 



— m 



Optional 



This parameter causes the disc drive arm to be 
physically positioned on the cylinder in which the 
specified block number is to be found. If the 
parameter is omitted, the seek operation will be 
performed when the following READ or WRITE 
macro is executed and the POSITN will merely 
update the block number. 

SEEK=YES should only be included when operating 
on an unshared file; this is because the position of the 
disc arm is not locked after a POSITN macro has been 
executed, and with a shared file the arm could 
therefore be repositioned by another user before data 
transfer had begun. If the SEEK on POSITN 
capability was not included in the operating system 
(SYSGEN), this operand is ignored. 



CNTRL — Hardware Control Operation 

The CNTRL request is used to perform a specific 
hardware control operation (this does not apply to 
spooled files going to disc storage). The operations 
allowed are dependent upon the device type. 
Standard error recovery is provided, with 
irrecoverable and logical errors terminating the 
operation and posting the return code in the request 
block. Control of the internal block number is 
maintained where possible, but if an operation is 
performed which does not maintain the block 
number, any subsequent request which needs a block 
number will be terminated with an error. 
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Name 



[tag] 



Operation 



CNTRL 



Operand 
IDENT-symbolic address 

i return= s s (] 

[ERRCOMP=j^ S }} 
OPER=operation code 



IDENT=symbolic address 

Specifies the address of a storage location containing 
the file identifier — the name by which the file is 
known to the program (as opposed to the external 
catalog name specified through Control Language). 
The file identifier must be eight bytes in length. 



list 1no J 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN^ 5 } 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is added, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP= 



YES I 
NO j 



Optional 



To be used when the user decides to retain control in 
the event of an error <ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



OPER=operation code 

• Reader/Punch 

OPER=SSn 

Select stacker on a card reader/punch. 
The numeric value of n is the stacker 
number. This command may only follow 
a READ to a file opened for modify 
usage. 



• Line Printer 

OPER=SPnn 

Space the printer form nn lines 
immediately. From 1 to 15 lines may be 
specified, depending on the hardware 
capability. 

OPER=SKnn 

Skip to carriage control tape channel nn 
immediately. 

The permissible values of nn are 1 
through 12, corresponding to channels 1 
through 12 of the printer carriage 
control. 

• Magnetic Tape 

OPER=REW 

Rewind tape. The internal block number 
will not be maintained. 

OPER=RUN 

Rewind and unload tape. The block 
number will not be maintained. 

OPER=ERG 

Erase gap (write blank tape). The block 
number will be maintained. 
OPER=BSR 

Backspace to interrecord gap. The block 
number will be maintained. 

OPER-FSR 

Forward space to interrecord gap. The 
block number will be maintained. 

OPER=FSF 

Forward space to tapemark (EOF). The 
block number will not be maintained. 

OPER=BSF 

Backspace to tapemark (EOF) or to Load 
Point if no tapemark is present. The 
block number will not be maintained. 

OPER=EOF 

Write End-of-File mark (tapemark). The 
block number will be maintained. 



• Disc Files 

0PER=EOF* 

Write End-of-File mark (a record 
containing a count field specifying a data 
length of zero). When read, this record 



'For disc, CNTRL will always write an EOF mark regardless 
of whether the OPOR-EOF operand is included or not. 
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will cause the system to set the EOF flag 
in the request block and in the File 
Description Table. The block number will 
be maintained. 



STATUS - Report of Status 

This request causes the system to pass information to 
a specified data buffer regarding the status of the file 
at the completion of the last operation to the file. 



RETURN' 



(YES) 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP=j^ S j 



Optional 



Name Operation Operand 

[tag] STATUS IDENT=symbolic address 

BUFADR=symbolic address 
BUFSIZ-symbolic address 

[ RETuRN= sn i 

[ ERRCOMP^^ 8 } ] 



IDENT=symbolic address 

Specifies the address of a storage location containing 
the file identifier — the name by which the file is 
known to the program (as opposed to the external 
catalog name specified through Control Language). 
The file identifier must be eight bytes in length. 



BUFADR=symbolic address 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

Between 20 and 24 bytes of file status information 
are available from the system, depending on the type 
of device (Table 7-1). The BUFSIZ specification 
determines how much of this information is to be 
returned, starting from the top of the table (this 
could be less than the total amount available, if 
specified). 

Table 7-2 gives the information for the status word of 
the Basic Data Channel operation; Table 7-3 gives the 
status word for Disc Channel operation. 

TYPE — Device and File Type 

This request causes the system to pass two bytes of 
information to the data buffer regarding the type of 
file and the type of device for which this file is 
prepared. 



Specifies the address of the data buffer. 



BUFSIZ=symbolic address 

Specifies the address of the memory word containing 
the byte count of the buffer. 



Name Operation 

[tag J TYPE 



Operand 



IDENT=symbolic address 
BUFADR=symbolic address 

YES) 

NO 



[ 



LIST- 



YEJ 
NO 

[ERRCOMP-Rio 5 }] 



[ 



RETURN^ 3 }] 



l Hno1 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



IDENT=symbolic address 

Specifies the address of a storage location containing 
the file identifier — the name by which the file is 
known to the program (as opposed to the external 
catalog name specified through Control Language). 
The file identifier must be eight bytes in length. 

BUFADR=symbolic address 

Specifies the address of the data buffer. 
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Table 7-1. Returned Information Format 
4 5 6 7 1 2 






— -r 


c | us 


B 


ud| l 


SF 


Last BIO Function 


2 
4 


Current Block Number 


6 


Error Field 


8 


EP 


iiiiiiiiiii 


FR 


H 


:r::^^3j:^1;j:^:lJi:i:i:i:^ jIH :H=U: ::h::^j: L^:^::^:::h^::H^::^^::U::::^^i::^H:: :^>: ^Uj:!^:= =!^ ! : -l :|U^::=: :r=:^ t^:^^::!^:;:: :=^:[:^>;:= 






10 


Block Size 


12 


Pointer to Current Command Word 


14 


Status of Last I/O Operation 


16 


Residual Count 



Disc: 



18 




PF 


PA 


WC 


DF 


|||l||igi||||||||||i|||||| 


No. of Residual Blocks 


20 
22 


Highest Block Written (per volume) 



Magnetic Tape: 




Unit Record: 



18 



Sense 


Unit Ordinal 



7-16 



Byte 



2-5 



6,7 



10,11 



Bit(s) 



2,3 



0-7 



0-7 
0-7 
0-7 
0-7 



0-7 



1,2 



5-7 



0-7 



0-7 



Table 7-1. Returned Information Format (Continued) 



Field Name 



Common stored data format flag (C) 



Usage Flag (US) 



Bypass Flag (B) 



Update Flag (US) 



Lockout Flag (L) 



Sequential File Flag (SF) 



Last BIO Function 



Current Block Number (four bytes) 



Error Field 



System Error Processing (EP) 



Not Used 



FDT Restore (FR) 



Hold Up Flag (H) 



Not Used 



Not Used 



Block Size 



Definition 



= not common stored data format 

1 = common stored data format 



00 = input 

01 = update 
10 = output 



= no bypass 

1 = bypass: 

READ goes to EOF 
WRITE is a NOP 



not update mode 
update mode 



= no lockout 

1 = file has been closed with lock 



= not sequential 

1 = sequential 



Last function processed in BIO 



Block number after last function processed. If zero, current 
block number is unknown 



When this field is non-zero, a RESET macro must be issued 
before making another request to the file 



= Call Error Recovery when an error is encountered 

1 = Bypass Error Recovery 



= FDT not restored 

1 = FDT restored 



Set when file is in error recovery to prevent further requests 
from being serviced 



Number of bytes in a physical record 
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Byte 



12,13 



14,15 



16,17 



Bit(S) 



0-7 



0-7 



0-7 



Table 7-1. Returned Information Format (Continued) 



Field Name 



Current CW Pointer 



Status 



Residual Count (RC) 



Definition 



Address of the current or last command word executed on 
this file 



Status of last I/O operation (see Tables 7-2 and 7-3) 



The difference between the number of bytes requested and 
the number of bytes transferred 



Disc 



18 



19 



20-23 



5-7 



0-7 



0-7 
0-7 
0-7 
0-7 



Not Used 



Paired File Flag (PF) 



Paired File Indicator (PA) 



Write Check (WC) 



Disc Driver Flag 



Not Used 



Residual Blocks 



Highest Block Written (HBW) 



not paired 
paired 



= first track of paired tracks 

1 = second track of paired tracks 



= no write check 

1 = write check on all writes 



Used internally by the driver only 



Number of blocks remaining to be set up for*a multiblock 
read request which crosses tracks 



Highest block number written for volume now mounted 



Magnetic Tape 



18-23 



Sense 



Sense bytes of the device at time of last error 



Unit Record 



18 



19 



0-7 



0-7 



Sense 



Unit Ordinal (UORD) 



Sense byte of the device at time of last error 



Unit table ordinal 
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Table 7-2. Status Word for Basic Data Channel Operations 



Byte 


Bit Set to 1 


Meaning 







1 
2 
3 


Attention 
Status Modifier 
Control Unit End 
Busy 


4 
5 
6 
7 


Channel End 
Device End 
Unit Check 
Unit Exception 


1 




1 
2 
3 


Initial selection sequence error, caused by one of the following: 
Unit not there 
Parity error on bus out 
Bad address 
Unit off-line 

Main storage buffer not exhausted 

Wrong Address-In returned on initial selection or bad parity on 'ADDRESS IN' 

No Request In on SIO Poll Sequence Request 


4 
5 
6 

7 


Control check 

Examine check (for data transfer only) 

Invalid command or zero byte count 

Unused 



7-19 



Table 7-3. Status Word for Disc Channel Operations 



Byte 


Bit Set to 1 


Meaning 







1 
2 
3 


I FA status not valid or command early 
IFA missed window or command early 
IFA window 
IFA track boundary 


4 
5 
6 
7 


IFA read/write termination 
IFA burst check error 
IFA lost data 
IFA no sync compare 


1 



1 

2 
3 


IFA 3rd rev sync find 

Disc (not on line) or (seek incomplete and not file unsafe) 
Disc (file unsafe) or (seek incomplete and not file unsafe) 
Disc read only 


4 
5 
6 
7 


Disc pack change 

Disc end of cylinder 

Disc write current sense or search fail (may be EOF) 

Disc busy 


All bits set 


Invalid function code in command program 
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—Ko s ) 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN 



I YES I 
1 NO J 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP; 



JYES 
I NO 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

The system responds to a TYPE request by placing 
two bytes of file information in the buffer in the 
following format: 






1 


2 3 


4 


5 


6 


7 


8 




15 




c 


US 


B 


UD 


L 


SF 


Device Type 



RESET - Reset Exception Conditions 

The RESET request allows a user to reset exception 
conditions in the file description table. The exception 
conditions lock out new I/O operations which would 
overlay the exception status indications. Examples of 
exception conditions are EOF and irrecoverable 
hardware conditions. 
Name Operation Operand 



[tag] 



RESET 



IDENT=symbolic address 
[RETURN-g^] 

C errco Hno S }] 



IDENT=symbolic address 

Specifies the address of a storage location containing 
the file identifier — the name by which the file is 
known to the program (as opposed to the external 
catalog name specified through Control Language). 
The file identifier must be eight bytes in length. 



H»} 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN= 



{YES 

|no 



Optional 



The first byte of this word is the same as the first 
byte returned by the STATUS macro. The second 
byte is a value representing the device type as defined 
following: 

0F-2F input/output devices 

20-3F input only devices 

40-5F output only devices 

60-7F input/output devices 

80-FF communications devices 

A more specific description of the bit significance in 
the device type code is illustrated in Table 7-4. 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP={^ S ) 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 
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Table 7-4. Bit Significance 



8 


9 


10 


11 


12 


13 


14 


15 











1 





X 


b 


a 








1 








X 


b 


a 





1 











X 


b 


a 





1 





1 


X 


X 


b 


a 





1 


1 





X 


X 


b 


a 





1 


1 


1 





X 


X 


X 


1 














X 


X 


X 



Bit assignment 
Card Reader/Punches 
Card Readers 
Card Punches 
Line Printers 
Magnetic Tape Units 
Disc Drives 
Communications Devices 



x = modifier bit 

a = 1 means hardware-buffered device 

b = 1 means early termination (on channel end rather than device end) 



PHYSICAL INPUT/OUTPUT MACROS 



EXCP - Input/Output Action 



Name 



[tag] 



Operation 



EXCP 



Operand 



[■ f@register numberH 

(symbolic address )J 
[■ (©register numberl -i 
(symbolic address I J 
[lJNORD=symbolic address] 

RETURN-gJ 5 }] 
[ ERRCOMP=P 



[ 



[YES 
iNO 



|] 



This is the physical I/O action macro (the "do I/O" 
macro). Basically, it generates the service request 
necessary to execute a command program in 
conjunction with a Physical Control Block (PCB) and 
for this purpose does not necessarily require any 
operands. However, it should be noted that two 
preconditions must be satisfied before the EXCP can 
function properly: 

• general register 6 must be loaded with a 
pointer to the associated PCB 

• the appropriate command program address 
must be loaded into the PCB 

If these two conditions are not already satisfied at the 
time the macro is issued, the following optional 
operands may be included in the macro for this 
purpose. 



(©register numberl 
I symbolic address J 



Optional 



This operand specifies the address of the PCB. If the 
parameter is omitted, the PCB location is assumed to 
be R6. An alternate register or a symbolic address 
may be designated to give the location of the PCB. 
The use of this keyword causes the contents of R6 to 
be destroyed. 



CP= 



|[@register number! 
-I symbolic address ) 



Optional 



This operand specifies the address of the appropriate 
command program. If this operand is omitted, the 
command program address is assumed to be in the 
PCB. If the keyword is used, a register (other than 
R6) or a symbolic address may specify the location of 
the command program to be executed. If the 
keyword is specified, the address of the command 
program is moved to the CPADR area in the PCB. 



UNORD=symbolic address 



Optional 



The operand must point to a user location containing 
the unit ordinal of the device on which the operation 
is to be performed. This will normally be the same 
address as the buffer specified in the physical OPEN 
macro associated with the device, since OPEN returns 
this value. 
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RETURN= 



JyesI 

NO j 



Optional 



To be used when the user program wishes to be 
given control immediately on recognition of the 
request, but before completion (RETURN=YES). 
When RETURN=NO is coded, or the default is 
taken, control will only be returned on completion 
of the request. 



ERRCOMP* 



m 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

PHYSICAL CONTROL BLOCK 

This is a data macro which generates the Physical 
Command Block necessary for performing a physical 
input/output operation. 



Name 



[tag] 



Operation 



PCB 



Operand 



[CPADR=symbolic address] 
|>ROPT={^}] 



[devtyp={urec| 
(disc J" 



J— ll 

={UREC>J 

(disc J 



[ 



ERROPT 



NO | 



=( 



FUNCTN=| ASKATT }l 
rU " U (REMOVE |J 



Optional 



Determines whether system error recovery is to be 
employed in the event that an error occurs when the 
command program is executed (by an EXCP macro). 



DEVTYP= 




Optional 



the user may then use this information for his own 
error processing provided that ERRCOMP=YES was 
coded in the corresponding EXCP macro. 



CPADR=symbolic address 



Optional 



This parameter specifies the location of the command 
program to be used with this PCB. The symbolic 
address should be the label used on the command 
program. If this parameter is omitted, the PCB will be 
assembled without a command program address; then 
this address must therefore be supplied dynamically 
at execution time by the corresponding EXCP macro. 



,,,_.. I ASKATT I 
FUNCTN= REMOVE 



Optional 



This optional parameter is used for executing 
functions which do not require a command program. 
When this parameter is coded the CPADR parameter 
is not required and will be ignored if present. 
FUNCTN=ASKATT causes the program to wait for 
an asynchronous attention from the device (such as 
disc pack change, line printer ready, magnetic tape 
loaded). If no attention is received following a 
FUNCTN=ASKATT request, the outstanding request 
must be cleared before the end of the job by issuing a 
FUNCTN=REMOVE request. FUNCTN=REMOVE 
clears all ASKATT requests from the particular device 
and returns them with an explanatory error code (see 
Appendix C). 



NOTE 

Since the completion of a FUNCTN=ASKATT 
request is dependent on outside action 
(operator, hardware) care should be exercised 
in its use (it is possible to give up control and 
never regain it). 

REMOVE and ASKATT functions cannot be chained. 



COMMAND 



Determines how much space is to be reserved in the 
generated PCB to receive sense information. 

• MT reserves three words 

• UR reserves one word 

• DISC and COMM reserve no space 

• Omitting the DEVTYP operand causes 
reservation of three words 

In the event that an uncorrectable error occurs, sense 
information will always be returned to the PCB and 



This single macro will generate a command word (or 
words)* for a physical input/output operation on 
unit record, magnetic tape, disc or communications** 
devices. Since the macro takes a wide variety of 
possible forms according to the type of device and 
operation for which it is being used, separate 
descriptions are given for each of the different classes 
as reflected in the value of the OPCODE operand. 



* The generated word is not directly executable code and 
must therefore be coded in a data area of the user's 
program. 
*• Details in Telecommunications Reference manual. 
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COMMAND Macro for Basic Data Channel 
(Unit Record Devices and Magnetic Tape) 

This macro generates a command word for physical 
input/output operations on card reader, card punch, 
line printer, magnetic tape, etc. (devices connected to 
the basic data channel). The generated command 
word specifies the hardware operation to be executed 
and, for commands that require data transfer, it 
designates the storage area associated with the 
operation. In addition, various operation modifiers 
may be supplied. 



Name 



[tag] 



Operation 
COMMAND 



Operand 

OPCODE=X'nn' 
[BUFADR=symbolic address] 
[BUFSIZ=decimal number] 



CHAIN' 



SIZERR 



[' 



SKIP= 



, I YES IT 

'NO 'J 

lYESH 

• no u 

|YESrj 

I NO I J 



OPCODE=X'nn' 



This parameter is a two-digit hexadecimal code 
specifying the hardware operation to be performed 
(see Table 7-5), or a command program jump 
command (OPCODE=X'08'). 

BUFADR=symbolic address Optional 

Specifies the address of the data buffer. 

BUFSIZ=decimal number Optional 

Specifies the length of the data buffer in bytes. The 
maximum allowable value is 65,535 bytes. BUFSIZ=0 
is not valid at execution time. 



CHAIN= 



(YES 



YES | 
NO ) 



Optional 



Indicates that another command word follows 
contiguously. Omission of this operand indicates that 
this is the last (or only) command word in the 
command program. CHAIN=NO represents the 
command word being the last one in the command 
program. 



sizer H^> s ) 



Optional 



Any difference between the length of the data record 
processed at the hardware-software interface and the 
size of the data buffer is detected by the I/O routines. 
This "incorrect length indication" is normally treated 
as an error condition and causes termination of a 
command program at that point. The SIZERR=YES 
operand (suppress length check) allows chaining to 



proceed regardless. SIZERR=NO causes termination 
of a command program at that point. 



— {mI 



Optional 



SKIP=YES causes suppression of the transfer of data 
into storage during this command word execution. 
SKIP==NO causes the transfer of the data storage. 

COMMAND 

Macro for DCABLE Operation 

Creates a command word for a physical disc 
operation to return the disc drive cable address. When 
an EXCP executes this command word it will read the 
status of the physical device identified in the related 
PCB and will place status indication in a two-byte 
buffer specified by BUFADR. 



Name 
[tag] 



Operation 



COMMAND 



Operand 

OPCODE=DCABLE 
BUFADR=symbolic address 
YESh 



[ chain ={no}] 



OPCODE=DCABLE 

Operation code for returning disc drive cable address. 

BUFADR=symbolic address 

Specifies the two-byte buffer area where the disc 
drive cable address will be returned. 



cha H^ s ) 



Optional 



Indicates that another command word follows 
contiguously in storage and is to be executed 
immediately after this one. CHAIN=NO represents 
the command word being the last one in the 
command program. 

COMMAND Macro for a DCSEEK Operation 

Creates a command word for a physical disc seek 
operation. When executed by an EXCP, this 
command word will cause a disc seek to the cylinder 
and track specified in a buffer pointed to by 
BUFADR. 



Name 



[tag] 



Operation 



COMMAND 



OPCODE=DCSEEK 



Operand 

OPCODE=DCSEEK 
BUFADR=symbolic address 

[CHA.N=0] 



Operation code for a disc seek. 
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Table 7-5. Peripheral Device Basic Hardware Operation Codes 



Device 


Operation 


OPCODE 


Card Reader (8010) 


Read (and Feed): 

EBCDIC mode 
Card Image mode 


02 
22 


Test I/O 

No Operation 

Sense 


00 
03 

04 


Line Printer (51 20, 5060) 


Write (no line spacing) 


01 


Write and Space 

Space 1 line 
Space 2 lines 
Space 3 lines 
Space 4 lines 

Space 14 lines 
Space 15 lines 


09* 
11 
19 
21 

71 
79 


Space Immediate: 
Space 1 line 
Space 2 lines 
Space 3 lines 
Space 4 lines 

Space 14 lines 
Space 15 lines 


0B* 
13 
1B 
23 

73 
7B 


Write and Skip: 

Skip to Channel 1 (top of form) 
Skip to Channel 2 
Skip to Channel 3 
Skip to Channel 4 

Skip to Channel 11 
Skip to Channel 12 


89* 

91 

99 

A1 

D9 
E1 


Skip Immediate: 

Skip to Channel 1 (top of form) 
Skip to Channel 2 
Skip to Channel 3 
Skip to Channel 4 

Skip to Channel 1 1 
Skip to Channel 12 


8B* 
93 
9B 
A3 

DB 
E3 


Test I/O 

No Operation 

Sense 


00 
03 

04 



*These numbers in the series are being incremented by eight. 
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Table 7-5. Peripheral Device Basic Hardware Operation Codes (Continued) 



Device 


Operation 


OPCODE 








Card Reader/Punch (8025) 


Readonly: 






EBCDIC mode 


0A 




Card Image mode 


2A 


Feed and Select Stacker: 






without offset 


23 




with offset 


A3 


Read, Feed and Select Stacker: 






EBCDIC mode, without offset 


02 




EBCDIC mode, with offset 


82 




Card Image mode, without offset 


22 




Card Image mode, with offset 


A2 


Punch, Feed and Select Stacker: 






EBCDIC mode, without offset 


01 




EBCDIC mode, with offset 


81 




Card Image mode, without offset 


21 




Card Image mode, with offset 


A1 


Test I/O 


00 




No Operation 


03 




Sense 


04 


Magnetic Tape (3237) 


Write Forward 


01 




Read Forward 


02 




Rewind 


07 




Rewind and Unload 


OF 


Backspace: 






Block 


27 




File 


2F 


Forward Space: 






Block 


37 




File 


3F 


Write Tapemark (End-of-File) 


1F 




Erase Gap 


17 


Force Error Mode: 






Set 


E3 




Clear 


D3 


Test I/O 


00 






/X5 




No Operation 


JX6 
| XD 
lXE 




Sense 


04 



7-26 



BUFADR=symbolic address 



BUFADR=symbolic address 



This specifies the address of a four-byte buffer which 
is assumed to have been preset by the user with the 
cylinder and track numbers to which the seek is to be 
made. The buffer format should be: 



7 



FBA 
FBA+2 

CHAIN= 



Cylinder number 



Track number 



I YES} 
I NO I 



Optional 



Indicates that another command word follows 
contiguously in storage and is to be executed 
immediately after this one. This parameter must be 
included to reserve the unit until the subsequent data 
transfer is complete. CHAIN=NO represents the 
command word being the last one in the command 
program. 



Specifies the address of a buffer containing the data 
to be used in comparing to the field being searched. 
This buffer must begin on a word boundary. 

BUFSIZ=decimal number 

Specifies the length of the field being searched for. 



FIELD= 



HA 
RZCNTj 

Irncnt) 



Optional 



Specifies the type of field for which to search. 
HA=home address, RZCNT=count field of record 
zero and RNCNT=count field of record n. If this 
parameter is omitted, HA is assumed. Following is a 
table specifying the field to search in order to read or 
write a desired field. 



COMMAND Macro for a DCSRCH Operation 

Creates a command word for a physical disc search 
operation. When executed by an EXCP, this 
command word causes a disc search to be performed. 
The search command allows the user to locate, on the 
current track, the data he wishes to process. This is 
done by analyzing the physical track records for type 
and content, searching for the record specified by 
BUFADR. When the specified record is found, the 
next contiguous command word in the command 
program is executed*. If the search fails to find the 
specified record on the track, the command program 
is discontinued at this point and the abnormal 
completion bit is set in the request block. 



Name 



[tag] 



Operation 
COMMAND 



Operand 

OPCODE=DCSRCH 
BUFADR=symbolic address 
BUFSIZ=decimal number 
(HA | 

rzcntJ] 
Irncnt) 



OPCODE=DCSRCH 



[field= 

[>™-0] 



Operation code for a disc search. 



*This will normally be a DCREAD or DCWRIT to read or 
write the actual data record associated with the search. The 
search should always be made for a field (usually a count 
field) preceding the record to be processed. Appendix E 
contains further information on the organization and 
structure of physical disc records. 



To Perform 




this DCREAD 


This DCSRCH 


or DCWRIT 


Operation is 


Operation: 


First Required: 


HA 


No search required 


Data 


RNCNT 


Key + Data 


RNCNT 


Count 


R(N-1)CNTorHA 


Count + Data 


R(N-1)CNTorHA 


Count + Key + 


R(N-1)CNTorHA 


Data 





Note that, when searching in preparation for a write 
operation, any fields that may be situated between 
the search field and the field to be written must be 
skipped using a DCREAD without transfer. 



CHAIN= 



JYES1 
NO f 



Optional 



Indicates that another command word follows 
contiguously in storage and is to be executed 
immediately after this one (almost always the case 
with the DCSRCH). CHAIN=NO represents the 
command word being the last one in the command 
program. 
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COMMAND Macro for a DCREAD Operation 

Creates a command word or chained group of 
command words for a physical disc read operation. 
When executed by an EXCP instruction, this 
command word (or group of command words) will 
cause a field (or number of fields) to be copied from 
disc into the specified buffer (or buffers). A 
multi-record data field read may be specified by 
including a BUFSIZ parameter which is a multiple of 
the DATSIZ parameter. However, when this is done, 
no other fields may be read by the same macro. 



Name 



[tag] 



Operation 



COMMAND 



Operand 

OPCODE=DCREAD 
HABUF=svmbolic address, 

HASIZ=decimal number 
DATBUF=symbolic address, 

DATSIZ=decimal number 
KEYBUF=symbolic address, 

KEYSIZ=decimal number 
CNTBUF=symbolic address, 

CNTSIZ=decimal number 
[BUFSIZ=decimal number] 



[ skip= 1no 

I YES 



IYESJ-J 






OPCODE=DCREAD 



Operation code for a disc read. 

HABUF=symbolic address 
HASIZ=decimal number 



Optional 



These two parameters are coded as a pair to indicate 
that a home address field is to be read. HABUF 
specifies the address of the buffer into which the 
home address is to be placed and HASIZ specifies the 
buffer length in bytes. 



DATBUF=symbolic address 
DATSIZ=decimal number 



Optional 



These two parameters are coded as a pair to indicate 
that a data field is to be read. DATBUF specifies the 
address of the buffer and DATSIZ specifies the length 
of the buffer, except in the case of multi-record reads 
(see BUFSIZ). 



KEYBUF=symbolic address 
KEYSIZ=decimal number 



Optional 



These two parameters are coded as a pair to indicate 
that a data field is to be read. KEYBUF specifies the 
address of the buffer, and KEYSIZ its length. 



CNTBUF=symbolic address 
CNTSIZ=decimal number 



Optional 



These two parameters are coded as a pair to indicate 
that a count field is to be read. CNTBUF specifies the 
address of the buffer, and CNTSIZ its length in bytes. 



BUFSIZ-decimal number 



Optional 



This parameter is to be coded for multi-record reads 
only. It indicates the overall length of the data buffer 
(DATBUF); it should be a multiple of the value of 
DATSIZ. 



SKIP= 



JYES) 

(no i 



Optional 



When this parameter is included no data will be 
transferred to memory so that fields may be skipped 
and/or the cyclic burst bytes* of a record may be 
checked. The SKIP=NO option (default) reads data 
into the buffer area. 



r-.n.r. |RZCNT\ 
F,ELD= iRNCNT| 



Optional 



This option gives the record in the count field. 
FIELD=RZCNT is record in the count field; 
FIELD= RNCNT is record n in the count field. 



chai H!S s } 



Optional 



Indicates that another command word follows 
contiguously in storage and is to be executed 
immediately after this one. CHAIN=NO (default) 
represents the command word being the last one in 
the command program. 

The following table illustrates the valid combinations 
of parameters which may be coded in a DCREAD 
macro. (In all cases SKIP=YES may be included to 
suppress data transfer.) 







Multi- 






Record 


Operation 


Buffer 


(BUFSIZ) 


Read Home 


HABUF 


No 


Address 






Read Data 


DATBUF 


Yes 


Read Key 


KEYBUF+DATBUF 


No 


and Data 






Read Count 


CNTBUF 


No 


Read Count 


CNTBUF+DATBUF 


No 


and Data 






Read Count, 


CNTBUF+KEYBUF 


No 


Key and Data 


+DATBUF 











'Appendix E has further details. 
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COMMAND Macro 
DCFWRIT Operation 



for a DCWRIT or 



Creates a command word or a chained group of 
command words for a physical disc write operation. 
When executed by an EXCP instruction, this 
command word (or group of command words) will 
cause data contained in the specified buffer (or 
buffers) to be transferred to the specified field (or 
fields) on disc. 

Note that with physical write operations to disc it is 
always necessary to specify the length of the variable 
gap which is to be written preceding a count field, or 
the fixed length gap preceding the home address field. 



Name 



[tag] 



Operation Operand 

COMMAND OPCODE- |°^ T } 

HABUF=symbolic address, 

HASIZ=decimal number 
DATBUF=symbolic address, 

DATSIZ=decimal number 
KEYBUF=symbolic address, 

KEYSIZ=decimal number 
CNTBUF=symbolic address, 

CNTSIZ=decimal number 
[GAP=hexadecimal number] 

[CHA.N-QJ 



KEYBUF=symbolic address 
KEYSIZ=decimal number 



Optional 



These two parameters are to be coded as a pair to 
indicate that a keyfield is to be written. KEYBUF 
specifies the address of the buffer containing the data 
to be written, and KEYSIZ specifies its length in 
bytes. 



CNTBUF=symbolic address 
CNTSIZ=decimal number 



Optional 



These two parameters are to be coded as a pair to 
indicate that a count field is to be written. CNTBUF 
specifies the address of the buffer containing the data 
to be written, and CNTSIZ specifies its length in 
bytes. Note that whenever a count field is to be 
written its associated variable gap length must be 
calculated. 



GAP=decimal number 



Optional 



The value of this parameter represents the length in 
bytes of an inter-field gap. The length of the gap will 
be fixed except when a count field is being written, 
in which case it must be calculated from the lengths 
of the preceding key and data fields on the track (see 
the following table). Appendix D gives the gap 
specifications. 

The following table illustrates the decimal number 
values given for the gaps preceding these values. 



OPCODE= 



| DCWRIT 
(DCFWRIT 



Optional 



Operation code for a disc write. OPCODE=DCWRIT 
specifies a normal write operation. 
OPCODE=DCFWRIT specifies a "format write": this 
is the same as a normal write except that, on 
completion, the rest of the track (up to the index 
mark) is filled with 1's (equivalent to a continuous 
gap). 



HABUF=symbolic address 
HASIZ=decimal number 



Optional 



These two parameters are to be coded as a pair to 
indicate that a home address field is to be written. 
HABUF specifies the address of the buffer containing 
the data to be written into the home address, and 
HASIZ specifies the buffer length in bytes. 



DATBUF=symbolic address 
DATSIZ=decimal number 



Optional 



These two parameters are to be coded as a pair to 
indicate that an actual data record is to be written. 
DATBUF specifies the address of the buffer 
containing the data to be written, and DATSIZ 
specifies its length in bytes. 



Operation 


Buffer 


Value to be 

Coded in 
GAP Operand 


Write home 
address 


HABUF 


32 


Write data 


DATBUF 





Write key 
and data 


KEYBUF+DATBUF 





Write Count 


CNTBUF 




Write count 
and data 


CNTBUF+DATBUF 


► (K+D)x.043 


Write count, 
key and data 


CNTBUF+KEYBUF 
+DATBUF 





K = length of preceding key field 
D = length of preceding data field 
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CHAIN= 



|YES| 
|N0 J 



Optional 



Indicates that another command word follows 
contiguously in storage and is to be executed 
immediately after this one. CHAIN=NO represents 
the command word being the last in the command 
program. 



FIELD=( RZCNT | 



Optional 



the optional LIST and ERRCOMP, only one other 
operand may be coded with this macro; depending 
upon the particular parameter used, the macro will 
wait for completion of: 

• any one of the outstanding requests (MODE 
= ANY) 

• all of the outstanding requests (MODE = 
ALL) 

• a specific outstanding request (REQADR = 
symbolic address) 



This option gives the record in the count field. 
FIELD=RZCNT is record in the count field; 
FIELD=RNCNT is record n in the count field. 



Note that when the REQCNT option is used the 
WAIT macro is satisfied on any of the following 
conditions: 



COMMAND Macro for a RESTORE 
Operation 

Creates a physical command word which, when 
executed by an EXCP, causes a disc restore operation. 



Name 



[tag] 



Operation 



COMMAND 



Operand 
OPCODE=RESTORE 



OPCODE=RESTORE 
Operation code for a disc restore. 

COMMAND Macro for a DCJUMP Operation 

Creates a physical command word which, when 
executed by an EXCP, causes the EXCP to next 
execute the command word located at the address 
specified by CWADR. This may be used to link 
command programs. 

Name Operation Operand 

[tag] COMMAND OPCODE=DCJUMP 

CWADR=symbolic address 

CWADR=symbolic address 

Specifies the address of the command word which is 
to be executed immediately following this one. 

CONTROL PROGRAM MACROS 

WAIT — Wait for Service Request Completion 



This macro is used to wait for the completion of one 
or more outstanding service requests. Execution of 
the requesting program will be suspended until 
completion of the specified request(s)*. Except for 



• When the WAIT macro is issued and the 
system detects that no requests are 
outstanding. 

• when the WAIT macro is issued and the 
count of outstanding requests is not equal to 
that specified by REQCNT 

• otherwise, when the first of any outstanding 
request operations is completed 



Name 



[tag] 



Operation 



WAIT 



Operand 



[-HE?] 

[REQADR=symbolic address] 
[REQCNT=symbolic address] 

[— (no S H 







ERRCOMP=)^ S }] 



„„,™,- (any) 

MODE- ALL 



Optional 



This operand provides the option of waiting for the 
completion of any one or all of the currently 
outstanding requests. 



REQADR=symbolic address 



Optional 



This operand should be used when it is desired to 
wait for the completion of a single specific request. 
The symbolic address must be the address of the first 
word in the request block (parameter list) of the 
specific request to wait for (not service request 
instruction itself). 



REQCNT=symbolic address 



Optional 



This operand specifies the location of a one-byte field 
containing the hexadecimal count of the number of 
requests known to be outstanding. Use of this 
operand gives a wait for the completion of any service 
request. 



"If none of the specified requests is outstanding at the time 
the WAIT is executed, control will be returned immediately 
to the requesting program. 
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HnoI 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated in line. 



ERRCOMP=j^ S j 



Optional 



LIST= 



(YES) 
|NO j 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



ERRCOMP; 



(YES) 
JNO 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



DELAY — Suspend Program Executiont 

This macro causes program execution to be 
suspended for a specified period of time, with the 
option of resuming on completion of any outstanding 
service request. The period of suspension may be 
specified either by the SECONDS operand or by the 
CYCLES operand (one of which is always required). 



Name 



[tag] 



Operation 



DELAY 



Operand 

SECONDS=symbolic address 
CYCLES=symbolic address 

[— Hn?}] 
[errcoiHn'o 8 }] 



INFORM — Service Request Completed 

The INFORM macro informs the requesting program 
that one of the program's outstanding service requests 
has been completed. INFORM returns control 
immediately to the user and subsequently indicates 
that a service request has been completed by setting 
the complete bit in the INFORM request block (bit 
of the third byte of the parameter list). The REQCNT 
operand points to a location containing a one-word 
count of the number of service requests which are not 
known to have been completed. The purpose of the 
count specification is to indicate whether any of the 
requests whose completion status is unknown have 
already been completed by the time the INFORM 
macro is executed (this will include the possibility of 
a request being completed in the interval between the 
issuance and actual processing of the INFORM). Thus 
the INFORM macro is satisfied by any one of the 
following conditions: 



SECONDS=symbolic address 



Optional 



Specifies the location of a one-word field containing 
the desired delay in seconds (hexadecimal). 



CYCLES=symbolic address 



Optional 



Specifies the location (hexadecimal) of a one-word 
field containing the desired delay in cycles (one cycle 
= 50.2 milliseconds). 



• when no service requests are outstanding 

• when the number of outstanding requests is 
less than that specified by REQCNT 

• when the first outstanding request is 
completed 



If when INFORM is issued, the number of 
outstanding requests exceeds the REQCNT 
specification, an error is assumed and the INFORM 
request is completed as abnormal. 



brea Hno S ( 



Optional 



BREAK=YES indicates that program execution is to 
be resumed immediately after any outstanding service 
request is completed. When this operand is omitted or 
BREAK=NO, the program will be resumed only when 
the specified delay time has elapsed. 

tNot available on minimal system. 



Name 



[tag] 



Operation 
INFORM 



Operand 



REQCNT=symbolic address 

["HI?}] 

[errcomp={n?)] 
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REQCNT=symbolic address 

Specifies the address of a one-byte location 
containing the number of service requests that are not 
known to have completed (outstanding). 



LIST= 



LIST= 



(YES) 
INO J 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



ERRCOMP: 



(YES) 
| NO j 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

POST — Create Compressed Communication Byte 

This macro, in conjunction with RPOST, is used for 
communication between user job steps. POST takes 
the first eight bytes located at INFOADR and 
interprets each byte to modify the corresponding bit 
in a compressed communication byte located in the 
Job Control Table*. At the start of a job the POST 
communication byte is initialized to zero. 

Name Operation Operand 



[tag] POST INFOADR=symbolic address 

[—en 

[RETURN-^}] 
[eRRCOMP-]^)] 



INFOADR=symbolic address 

Specifies the location of an eight byte buffer 
containing the information to be posted. The buffer 
should contain only EBCDIC O's, 1's or X's. These 
bytes will be interpreted as follows to modify the 
corresponding eight bits in the communication byte: 

EBCDIC = reset bit to 
EBCDIC 1 = set bit to 1 
EBCDIC X = leave bit unchanged 



YESl 
NO | 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN -{^1 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP=(^ S ) 



Optional 



*This scheme is compatible with IBM's UPSI bit mechanism. 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

RPOST — Expand from Communication Byte 

This macro is used to read information, located in an 
interjob step communication area, which was posted 
there either by a POST macro in a previous job step 
or by the SWITCH=parameter in a //SET Control 
Language statement*. Each bit in the one-byte 
communication area is expanded to an EBCDIC 
equivalent and placed in the buffer specified by 
INFOADR. 

Name Operation Operand 

[tag] RPOST INFOADR=symbolic address 

[return-^)] 

[ ERRCOMl-j^ S }] 



INFOADR=symbolic address 

Specifies the location of an eight-byte buffer where 
the interpreted information will be placed. Each bit 
in the communication byte will be converted to an 
EBCDIC byte as follows: 

Binary = EBCDIC 
Binary 1 = EBCDIC 1 
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LtST= 



YES 
NO 



Optional 



LIST 



,|YES| 

|no J 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately, LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN={^ S ) 



Optional 



RETURN= (^ S ) 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
bubefore completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



To be used when the user program wishes to be given 
control immediately on recognition of the request 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP=(^ S } 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



ERRCOMP; 



-P 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



SETCOM - Transfer to Job Control Table 

This macro, in conjunction with GETCOM, is used 
for communication between user job steps. It 
transfers, without modification, eight bytes of 
information located in a user-specified buffer to an 
eight-byte communication area in the Job Control 
Table where it may be picked up by a GETCOM in a 
subsequent job step. At the start of a job the 
communication area is initialized to all blanks. 



GETCOM — Transfer from Job Control Table 
Communication Area 

This macro is used to obtain the information which 
had been placed in an eight-byte communication area 
by a SETCOM executed in a previous job step. The 
content of the communication area, located in the 
Job Control Table, is moved, without modification, 
to an eight-byte buffer specified by INFOADR. 



Name 



Operation 



SETCOM 



Operand 



INFOADR=symbolic address 

[return-^ 5 }] 
[errcomp={^ s |] 



Name 
[tag] 



Operation 



GETCOM 



Operand 



INFOADR=symbolic address 



LIST= 



lYES 



(NO 



}] 



RETURN* 



fi?0 



>RRCOW-G S |] 



INFOADR=symbolic address 



INFOADR=symbolic address 



Specifies the location of an eight-byte buffer 
containing the data to be transferred to the 
communication area. 



Specifies the location of an eight-byte user buffer 
into which the contents of the communication area 
will be moved. 
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L,ST=J YES 1 



■|no I 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



retu H^ s I 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP 



-{»} 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



ACCEPT - Read //PAR Card 

This macro is used to obtain data contained on //PAR 
cards supplied in the Control Language deck. 
ACCEPT transfers the EBCDIC content of a single 
//PAR card to the buffer specified by DATBUF1. 

The particular //PAR card read by the ACCEPT is 
determined by a pointer located in the Job Control 
Table. At the start of the job step, this pointer is 
initialized to point to the first //PAR card so that the 
first ACCEPT executed in the step will read the first 
//PAR card supplied with this step. Each time an 
ACCEPT is executed the //PAR card pointer is 
updated to the next consecutive card so that on the 
next execution the next //PAR card will be read. 

If, when an ACCEPT is executed, there are no more 
//PAR cards left to be read, control will be 
transferred to the location specified by the ENDADR 
operand. 



content of the user counter specified by PARNUM 
will be incremented by 1 so that this same ACCEPT 
may be re-executed to read the next //PAR card. 

The format of the data transferred to the buffer 
consists of a four-byte Common Stored Data Format 
(CSDF) control header preceding the data from the 
//PAR card, unless the optional operand CSD=NO is 
included. The content of the //PAR card is always 
stripped of characters through the first blank (so as 
not to include "//PAR" itself) and is also stripped of 
the sequence number field (columns 73 through 80) 
unless the optional operand STRIP=NO is included. 



Name 



[tag] 



Operation 



ACCEPT 



Operand 

DATBUF1=symbolic address 
[CSD=NO] 
[STRIP=NO] 

[PARNUM=symbolic address] 
ENDADR=symbolic address 

o™=(Lo s }] 

[errcomp={^ s |] 



DATBUF1=symbolic address 

Specifies the location of the buffer into which the 
data from the //PAR card will be transferred. 



CSD=NO 



(Optional) 



If this operand is used the parameter line will not be 
preceded by the CSDF control header. 



STRIP=NO 



(Optional) 



If this operand is used the Sequence Number Field 
(card columns 73 through 80) will not be stripped. 



PARNUM=symbolic address 



(Optional) 



Specifies the location of a one-word binary counter 
whose value is to be used as a //PAR card pointer. A 
value of 1 will cause the first //PAR card to be read, 
and 2 the second, and so on. Each time the ACCEPT 
is executed, the value of the counter will be increased 
by 1. 

ENDADR=symbolic address 



The optional operand PARNUM allows the //PAR 
pointer to be set to any desired //PAR card by 
specifying a user location containing a count (since 
the //PAR cards are considered to be numbered 1 
through n by implication). Each time an ACCEPT 
macro with a PARNUM specification is executed, the 



This required operand specifies the program address 
where control is to be transferred if all the //PAR 
cards have been read (value of system's //PAR 
counter greater than number of //PAR cards 
supplied) or if the PARNUM specified is greater than 
the number of //PAR cards supplied. 
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— p 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN=(^ S } 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request, 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP=j^ S ) 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 

DISPLAY - Write Message on SYSOUT 

The DISPLAY macro is used for writing a one-line 
message on the SYSOUT file. The address of the 
message buffer, which must be aligned on a word 
boundary, is specified by DATBUF. The format of 
the buffer must be as follows: 



Space for CSDF Control Header 
(4 bytes) 



ASA carriage control 
character 



message byte 2 



message byte n-1 



message byte 1 



message byte 3 



message byte n 



The first four bytes of the buffer are reserved for a 
Common Stored Data Format (CSDF) control header 
to be generated by the system. The fifth byte, 
preceding the message, is an ASA carriage control 
character* (not to be printed) and the message itself 
is an EBCDIC character string up to 132 bytes in 
length, starting in the sixth byte. If the message is 
shorter than 132 bytes, a storage location containing 
the length must be set up and the DATSIZ operand 
must be included in the call. 



* Details in Control Program and Dsita Management Services 
— Basic Reference. 



Name Operation Operand 

[tag] DISPLAY DATBUF=symbolic address 

[DATSIZ=symbolic address] 

[E R RCOMP=j^ S j] 



DATBUF=symbolic address 

Specifies the address of the first byte in the message 
buffer. This will be the address of the space reserved 
for the CSDF control header and the first byte of the 
message itself (the ASA control character) should be 
displaced 4 bytes from this address. 



DATSIZ=symbolic address 



Optional 



Specifies the address of a one-word location 
containing the length of the message. If this operand 
is omitted, the message length is assumed to be 132 
bytes. 



ERRCOMP 



JYESJ 
\NO f 



Optional 



If ERRCOMP=YES is specified, the program is not 
aborted. When ERRCOMP=NO is coded, or the 
default is taken, the program will be aborted if an 
error occurs. 

MEMLIM - Identify Partition Limit 

This macro returns the first byte address of the 
highest addressable 256-byte page of storage available 
to the problem program in the partition in which the 
program is running. The returned address is expressed 
as the absolute address of the first word of the last 
addressable page. MEMLIM is intended for enabling 
programs which are expected to run in partitions of 
various different sizes to "spread themselves out" to 
occupy as much space as is available (in the interest 
of efficiency). In this situation, the partition space 
pool should always be fixed by means of the 
appropriate Linkage Editor directive.* 



Name 



[tag] 



Operation Operand 

MEMLIM INFOADR=svmbolic address 

[-Hno S |] 

[RETURN-g 5 }] 

[errcomp=|^ s |] 



* Linkage Editor portion of Program Library Services 
Reference. 
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INFOADR=symbolic address 



INFOADR=symbolic address 



Specifies the location of a two-byte area where the 
address of the highest addressable 256-byte page is to 
be placed. 



Specifies the location of the one-byte (EBCDIC 
character) of data to be posted in the IF code field of 
the Job Control Table. 



— InoI 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates the parameter 
table (list) only. When no LIST operand is specified, 
both the service request and the parameter table are 
generated. 



RETURN-)^ 5 ) 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



ERRCOMP=(^ S [ 



Optional 



H» 



Optional 



To be used when either the system linkage (service 
request instruction) or the parameter table is to be 
generated separately. LIST=NO generates the service 
request only; LIST=YES generates parameter table 
(list) only. When no LIST operand is specified, both 
the service request and the parameter table are 
generated. 



RETURN=(^ S 1 



Optional 



To be used when the user program wishes to be given 
control immediately on recognition of the request 
but before completion (RETURN=YES). When 
RETURN=NO is coded, or the default is taken, 
control will only be returned on completion of the 
request. 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an irrecoverable error 
occurs. 



SETIF — Post Code for Control Language Test 



ERRCOMP= 



(YES) 
\NO J 



Optional 



To be used when the user decides to retain control in 
the event of an error (ERRCOMP=YES). When 
ERRCOMP=NO is coded, or the default is taken, the 
program will be aborted if an error occurs. 



This macro enables a program, running as one step of 
a multi-step job, to post in the Job Control Table 
(usually at step completion) a code which may be 
tested by a Control Language //IF statement* in 
order to govern the subsequent course of the job. The 
code to be posted is one byte in length (EBCDIC 
character); its address is specified by INFOADR. 



Name 



[tag] 



Operation 



SETIF 



Operand 
INFOADR=symbolic address 

[errcomp-{^|] 



HALT — Terminate Program 

The HALT macro is used to perform normal 
termination of a user's program step. This macro will 
not result in a memory dump unless DUMP=YES has 
been coded in the //EXECUTE statement associated 
with the program. The format for HALT is as 
follows: 



Name Operation 



[tag] HALT 



Operand 



*See Control Language Services Reference. 
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EHALT — Terminate Program 

The EHALT (error halt) macro is used to request 
termination of a user's job. This macro will not 
automatically give a memory dump unless 
DUMP=YES has been coded in the //EXECUTE 
statement associated with the program. The format 
for EHALT is as follows: 



Name Operation 



Operand 



[tag] 



EHALT 



ABEND - Terminate Program Abnormally 

The ABEND macro is used to request abnormal 
termination of a job, and to pass a completion code 
to Job Monitor for display. A dump will be given 
unless DUMP=NO is specified on the //EXECUTE 
statement. The completion code is a 16-bit binary 
value. The format for ABEND is as follows: 



Name Operation Operand 

tag SDATE 



INFOADR=symbolic address 



MODE={-j-} 

INFOADR=symbolic address 

Specifies the first byte address of the area that 
receives the data. 



MODE= 



■(f) 



Specifies the current date in the calendar (C) 6-byte 
format mmddyy or the Julian (U) 5-byte format 
yyjjj. The default value is C. 



Name Operation 



[tag] ABEND 



Operand 



INFOADR=symbolic address 



INFOADR=symbolic address 

Specifies the first byte address of the area containing 
the completion code. 



TIME - Retrieve Time of Day 

The TIME macro returns the current time of day in 
the operand specified. The time of day is returned in 
an unpacked decimal format: hhmmss, where hh is 
the hour, mm is the minute, and ss is the second. The 
format for TIME is as follows: 



Name Operation 



[tag] TIME 



Operand 



INFOADR=symbolic address 



JDATE - Retrieve Job Date 

The JDATE (job date) macro returns the date 
provided for by a //SET statement. The date returned 
will be the system date unless the //SET statement 
has specified a job date. The date is returned in one 
of two unpacked decimal formats: mmddyy or yyjjj, 
where mm is the month, dd is the day, yy is the year, 
and jjj is the Julian day. The format for JDATE is as 
follows: 



Name Operation 



tag 



JDATE 



Operand 

INFOADR=symbolic address 
MODE=(-j-} 



INFOADR=symbolic address 

Specifies the first byte address of the area which 
receives the date. 



INFOADR=symbolic address 

Specifies the first byte address of the area which 
receives the time. 



SDATE - Retrieve System Data 

The SDATE (system date) macro returns the system 
data in the operand specified. The date is returned in 
one of two unpacked decimal formats: mmddyy or 
yyjjj. where mm is the month, dd is the day, yy is the 
year, and jjj is the Julian day. The format for SDATE 
is as follows: 



=1x1 



MODE 



Specifies the current date in the calendar (C) 6-byte 
format mmddyy or Julian (J) 5-bit format yyjjj. The 
default value is C. 



CONSOLE COMMUNICATION MACROS 

Two macros, CONSOLE (an active macro) and 
MESSAGE (a data macro), are available for 
communicating with the operator's console. 
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CONSOLE — Transmit Message to Console and 
Optionally Receive Reply 

The. CONSOLE macro enables programs to transmit 
messages to the operator's console and optionally 
receive replies. The main-storage format of the 
message to be sent to the console must include two 
fields, a control block which is not typed and the text 
field which contains the actual message. The buffer 
set up to receive a reply from the console (if any) 
must contain a control block followed by the actual 
buffer for the reply text. The format of CONSOLE is 
as follows: 

Name Operation Operand 



DATBUF1=symbolic address 



(Optional) 



[tag] CONSOLE DATBUF1=symbolic 

address 
[DATBUF2=svmbolic 
address] 



Enables a name to be attached to the beginning of the 
message text field. 

DATSIZ1=decimal number 

Specifies the decimal length (in bytes) of the message 
text. If no length is specified, the text length will be 
used. If there is no message, a length of zero is 
assumed. The maximum value of DATSIZ1 is 100. 

DATATXT=character string 

Specifics the actual message to be placed in the 
message text field. It is created in EBCDIC and may 
be up to 100 characters (bytes) long. The default is a 
string of blanks, with length being determined by the 
parameter DATSIZ1. The character string must be 
coded in the form, C'message text'. 



DATBUF1=symbolic address 

Specifies the address of the message control block 
which is followed by the message test. 



DATBUF2=symbolic address 



(Optional) 



Specifies the address of the reply control block which 
is followed by the reply buffer area. 



MODE= 



W 



(Optional) 



Specifies whether the message is informative (I) or 
directive (D). MODE=D indicates that the message 
calls for some operator action. The default value of 
MODE is I. 



MESSAGE - Set Up Message Format 

The MESSAGE macro, to be used in conjunction 
with the CONSOLE macro, simplifies the generation 
of messages by creating the correct format required 
by CONSOLE. A tag is required for all MESSAGE 
macros so that the corresponding CONSOLE macro 
may locate it. Two formats exist for the MESSAGE 
macro, one for generating an output message and one 
for generating a reply buffer. 

Generation of an Output Message 

The format for generating an output message is as 
follows: 



Generation of a Reply Buffer 

The format for generating a reply buffer is as follows: 

Name Operation Operand 

tag MESSAGE [DATBUF2=symbolic address] 

DATSIZ2=decimal number 



DATBUF2=symbolic address 



(Optional) 



Enables a name to be attached to the beginning of the 
reply text field. 



Name Operation Operand 



MESSAGE [DATBUF1 -symbolic address] 

iDATSIZ1=dfioimal number j 
DATATXT=character string I 

[mode={-L}] 



DATSIZ2=decimal number 

Specifies the decimal length in characters (bytes) of 
the reply buffer to be generated. The reply field will 
be assembled with blanks. The maximum value of 
DATSIZ2 is 100. 
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A. PACK CATALOG AND CENTRAL 
CATALOG FORMATS 



The formats used by the pack catalog and central 
catalog of the disc are discussed in the following 
paragraphs. 

PACK CATALOG 

Figures A-1 through A-5 illustrate the use of the 
name, attribute and space elements in generating the 
pack catalog. The normal block of the pack catalog is 
128 bytes, and the continuation element is 64 bytes 
for normal files and 128 bytes for a continuation to 
the description of pack space, which is catalog blocks. 

At disc initialization time, the pack catalog is created 
with block formatting as follows (assuming the pack 
contains the central catalog): 

Block 1 Entry that describes the pack 

catalog itself 

Block 2 Entry that describes the space 
available on the pack 

Block 3 Entry that describes the space 
occupied by the central catalog 

Block 4 First block of space available in 
the pack catalog. Name element 
fields are filled as follows: 

Control bytes X'8200007C 

Next name X'000500' 

Previous name X'000000' 



Block 5-n Remaining blocks of space are 
constructed in the same format as 
block 4 with proper linking 
through the next name and 
previous name fields. 

During the process of allocating a data file, one of the 
available blocks is removed from the string of 
available pack catalog blocks and is linked into the 
chain describing existing files. When space is needed 
for a continuation element, another block is removed 
from the available chain. Half of the block is used for 
a continuation element and the other half is linked to 
start the chain of available continuation space. 

CENTRAL CATALOG 

Figures A-6 through A-8 illustrate the use of the 
name, attribute, and volume elements in constructing 
entries for the central catalog. The normal block size 
of the central catalog is 128 bytes, and the 
continuation element is 64 bytes. 

At disc initialization time, the first block is formatted 
as shown in Figure A-7. Remaining blocks are 
considered available and are linked as those in the 
pack catalog. 
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CONTROL BYTES FOR NAME EL EMENT 



FILE NAME: X'OOOHB' 



POINTERS TO ATTRIBUTE ELEMENT, SPACE 
ELEMENT AND AVAILABLE PACK CATALOG 
BLOCKS, AVAILABLE PACK CATALOG 
CONTINUATION ELEMENTS 



33 

34 



CONTROL BYTES FOR ATTRIBUTE ELEMENT 



63 
64 



CONTROL BYTES FOR SPACE ELEMENT 



NAME 
ELEMENT 



ATTRIBUTE 

ELEMENT 



\ 



7 SEGMENTS WITH 

UNUSED BYTES 

AT THE END 



127 



SPACE 
ELEMENT 



Figure A-1 . Block 1 — Pack Catalog Entry in Pack Catalog 
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CONTROL BYTES FOR NAME ELEMENT 

FILENAME: X'00024B' 
POINTERS TO SPACE ELEMENT 



21 
22 



CONTROL BYTES FOR SPACE ELEMENT 



14 SEGMENTS WITH 

UNUSED BYTES 

AT THE END 



127 



NAME 
ELEMENT 



\ 



SPACE 
ELEMENT 



/ 



Figure A-2. Block 2 — Space Entry in Pack Catalog 
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25 
26 



55 
56 



127 



CONTROL BYTES FOR NAME ELEMENT 



FILENAME: X'00034B' 



POINTERS TO ATTRIBUTE ELEMENT 
AND SPACE ELEMENT 



CONTROL BYTES FOR ATTRIBUTE ELEMENT 



CONTROL BYTES FOR SPACE ELEMENT 



8 SEGMENTS WITH 

UNUSED BYTES 

AT THE END 



NAME 
ELEMENT 



ATTRIBUTE 

ELEMENT 



\ 



SPACE 
ELEMENT 



/ 



Figure A-3. Block 3 — Central Catalog Entry in Pack Catalog 
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CONTROL BYTES FOR NAME ELEMENT 



NAME 
ELEMENT 



POINTERS TO ATTRIBUTE ELEMENT, 

SPACE ELEMENT, AND 

ASSOCIATED NAME ELEMENT 



49 
50 



CONTROL BYTES FOR ATTRIBUTE ELEMENT 



ATTRIBUTE 
ELEMENT 



79 
80 



CONTROL BYTES FOR SPACE ELEMENT 



4 SEGMENTS WITH 

UNUSED BYTES 

AT THE END 



SPACE 
ELEMENT 



127 



Figure A-4. Block 4-n — Normal File Entry in Pack Catalog 
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CONTROL BYTES FOR SPACE CONTINUATION 



63 



Figure A-5. Pack Catalog Space Element Continuation 
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CONTROL BYTES FOR NAME ELEMENT 



FILENAME: X'00014B' 

POINTERS TO ATTRIBUTE ELEMENT, VOLUME 
ELEMENT, AVAILABLE CENTRAL CATALOG 
BLOCKS, AND AVAILABLE CENTRAL CATALOG 
CONTINUATION ELEMENTS 



33 
34 



CONTROL BYTES FOR ATTRIBUTE ELEMENT 



63 



CONTROL BYTES FOR VOLUME ELEMENT 



NAME 
ELEMENT 



ATTRIBUTE 

ELEMENT 



4 VOLUMES 



127 



VOLUME 
ELEMENT 



Figure A-6. Block 1 — Central Catalog Entry in Central Catalog 
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CONTROL BYTES FOR NAME ELEMENT 



POINTERS TO ATTRIBUTE ELEMENT, 

VOLUME ELEMENT, AND 

ASSOCIATED NAME ELEMENT 



49 
50 



CONTROL BYTES FOR ATTRIBUTE ELEMENT 



79 
80 



CONTROL BYTES FOR VOLUME ELEMENT 



NAME 
ELEMENT 



ATTRIBUTE 
ELEMENT 



3 VOLUMES 



127 



VOLUME 
ELEMENT 



Figure A-7. Block 2-n — Normal File Entry in Central Catalog 
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CONTROL BYTES FOR VOLUME CONTINUATION 



63 



Figure A-8. Central Catalog Volume Element Continuation 
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B. SERVICE REQUEST MECHANISM 
AND MACRO EXPANSIONS 



INTRODUCTION 

There are essentially two types of system macro 
instructions: action macros and data macros. Action 
macros, which expand into executable code, may be 
further subdivided into user code macros and service 
request macros. User code macros expand into code 
which is primarily executed within the user's program 
(except for possible nested service request macros). 
Service request macros, on the other hand, link to 
system routines for their implementation. 

Examples: 

GET, DISPLAY user code macros 
READ, GETCOM service request macros 
MESSAGE, COMMAND data macros 

Most of the control program and block input/output 
macros are service request macros whereas most of 
the physical input/output macros are data macros. 

The expansions of all service request macros contain a 
service request machine instruction. 

SERVICE REQUEST INSTRUCTION 

The Service Request instruction (mnemonic SR) is 
the only means by which a user program* may 
communicate with the operating system. In practice, 
however, there is no need for the user to code this 
instruction directly, since it will automatically be 



generated in the expansion of a service request macro 
instruction. Figure B-1 illustrates the control path 
between a user program and operating system. 



SERVICE REQUEST MACRO EXPANSION 
CONVENTIONS 

The expansions of all* service request macros will 
normally begin with the following standard three 
words (with no LIST operand used): 



Byte 



Byte 



7 



Service Request Instruction 



Function Code 



Length 



Return Information 



Any additional words in the expansion are uniquely 
defined for each macro. 

SERVICE REQUEST INSTRUCTION (BYTES 
AND 1) 

This instruction establishes the link with the 
operating system; it is defined as follows. 



•This same method is also often employed by system 
programs to communicate with each other. 



'Except for the physical input/output macro, EXCP. 
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Figure Et-1. Service Request Linkege to System 
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ByteO 




Service Request 
Function Code 


1 


R 


EP 




Request 
Class 



Service Request Function Code: SR = X'13' 
I: parameter list location indicator 

immediately following this instruction 

1 at location whose address is contained in 
register 6 

R: Return indicator 

return control only after request is completed 

1 return control immediately after request is 
accepted 

EP: User error processing indicator 

user program to be aborted on occurrence of 
an error 

1 user to retain control after an error 
Request Class: Major class of service request 

= Debug Request (system only) 

1 - Restricted Request (system only) 

2 = Control Program Flequest 

3 = Block Input/Output Request 

4 = Illegal 

5 = Supervisor Request 

6 = Telecommunications Request 

7 = Physical Input/Output Request 

FUNCTION CODE (BYTE 2) 

Function or operation code for this request (see 
individual expansions). 



LENGTH (BYTE 3) 

Number of words in this request block, excluding the 
service request instruction (see individual 
expansions). 

RETURN INFORMATION (BYTES 4 AND 5) 

This word is an area where the system will return 
information developed during the execution of the 
request. On initial receipt of the request the whole 
word will be set to zero. The return information field 
is defined as follows: 

Byte 5 



7 




Complete Bit (C) 

This bit will be set by the system to indicate that the 
request has been completed (normally or otherwise). 

Error Flag (E) 

When this bit is set an abnormal completion is 
indicated in which case the remainder of the word 
will contain information connected with the error. If 
the error flag is not set, no further information will 
be contained in this word (except in the case of 
END). This bit may be set on completion even if the 
EPbit is not set in the SR. 



End Flag (END) 

When set, this bit indicates that one of a number of 
possible end conditions has been detected. The 
particular end condition is specified by the return 
code in byte 5, as follows: 



00 
01 
02 
03 
04 
05 



Disc EOA (end of allocation) 
Printer Channel 12 
Disc EOF (end of file) 
Card Reader EOF 
Printer Channel 9 
Printer Channels 9 and 12 



c 


E 


END 


Not Used 


Return Code 



Return Code 

This eight-bit code contains specific information 
about the error (return code, Table C-1, Appendix C). 

OPTIONAL PARAMETERS 

Three keyword parameters are usable by most block 
I/O level service request macros: RETURN, 
ERRCOMP, and LIST. The LIST parameter gives the 
option of separating the parameter packet and service 
request instruction, or not doing so. 

If LIST=YES, the RETURN and ERRCOMP 
parameters cannot be used; if LIST=NO, the 
RETURN and ERRCOMP parameters are the only 
other parameters which can be used. However, if 
LIST is omitted, these two parameters can be used 
independently. 

LIST 

If LIST=YES, only the appropriate parameter packet 
is generated. The LIST=YES option allows the 
generation of the macro parameter packet only once 
in the program. 
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If LIST=NO, only a 2-byte standard service request 
instruction is generated. The user must load into 
general-purpose register 6 (R6) the address of the 
parameter packet to be referenced and into register 7 
(R7) the address of the save area address prior to 
issuing the LIST=NO option. 

The 2-byte service request instruction has the 
following format, where 05 defines the Data 
Management expansions and 13 the function code. 



13 


05 



Example: 



1 2 3 ( 'j S 7 8 



sav.ij. 



2 13 14 19 IB 17 






_ OfJM. 



wj>J>. 



19 20 21 22 21 24 25 26 27 28 29 30 31 32 33 3a 35 36 37 38 39 40 41 42 43 4 



k.l .SX.'A». l H.tT'lRMm XtA^ 



J..i.\J."X.t.t. > .tl.S\*.i.-.l. . ... . 



With the LODD instruction, the user loads into R6 
the address of a parameter packet which has been 
specified elsewhere in the program (TAG 5), and the 
save area address (SA VEIT) into R7. 



The LIST default for the OPEN request results in the 
generation of the service request instruction followed 
by the OPEN parameter packet. 



RETURN 

The RETURN parameter enables the user to request 
that control be returned to his program immediately 
after the service request has been received and 
recognized by the system (but before the function it 
requests has been completed). By coding 
RETURN=YES, the user may save time by 
proceeding with his own processing while the system 
is processing the service request. When 
RETURN=YES is used, detection of request 
completion becomes a user responsibility (he must 
check the complete bit in the return information 
word of the request parameter list). The RETURN 
parameter is mostly applicable to input/output 
service requests, which are relatively slow to 
complete. The default specification, RETURN=NO 
may be coded explicitly if desired. (Note that there 
are certain service request macros on which the 
RETURN parameter is not available.) 



ERRCOMP 



With the' OPEN macro and a LIST=NO parameter 
specified, only the 2-byte executive request code is 
generated. 

At TAG 5, the OPEN parameter list is generated. 

If the LIST option is omitted, the service request 
instruction is generated followed by the appropriate 
parameter list. The user must load the address of the 
save area into R7 prior to issuing the call. 



The ERRCOMP parameter allows the user to retain 
control when an error occurs which the system was 
unable to correct. By coding ERRCOMP=YES the 
user has the option of attempting to correct any 
errors or of simply ignoring* them and continuing. 
The default condition ERRCOMP=NO, which may be 
coded explicitly if desired, results in a program abort 
in the event of an error (which the system was unable 
to correct). 



13 


05 










OPEN 
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OPI RATION 




OPERAND 


1 2 3 i b G 1 3 


9 
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STANDARD SYSTEM SUFFIXES 

If the programmer wishes to reference a particular 
word of a parameter packet, he may do so by adding 
the standard system suffix to his tag name (name 
symbol). If the tag name is six characters or less, the 
standard suffix is appended to the tag name. If the 
tag name is seven or eight characters, this (these) last 
character(s) is (are) truncated and the standard suffix 
is appended. For this reason the first six characters 
must be unique. The standard suffixes are listed 
alongside the macro expansion with the suffix across 
from the appropriate parameter packet word. 



"Occasionally, a condition may arise which is classified by 
the system as an error but which does not affect the 
outcome of the user program. 
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For an example: if the programmer wishes to 
reference the word containing the file type of the 
ALLOC macro, it is located in byte 5 which is 
referenced by the F1 suffix. If his tag name is JOB65, 
the word may be referenced with JOB65F1. 
However, if his tag name is MYJOB658, the reference 
isMYJOB6F1. 



EXPANSION TABLES 

The expansion of each macro is detailed in the 
following pages; generally there is a map of the bytes 
as stored, followed by detailed assignments of bytes 
and bits. 

The macros are listed in these groupings: 

• Data Management 

ALLOCATE 

EXPAND 

PURGE 

OPEN 

CLOSE 

CLOVE 

LABRTN 

• Block I/O 

STATUS/TYPE 
CONTRL/POSITN 
READ/WRITE 
RESET 

• Physical I/O 

EXCP 
PCB 

COMMAND (various applications) 



• Control Program 

WAIT 

POST/RPOST 

SETCOM/GETCOM 

ACCEPT 

DISPLAY 

MEMLIM 

INFORM 

SETIF 

DELAY 

HALT 

EHALT 

ABEND 

TIME 

SDATE 

JDATE 



• Console Communications 
CONSOLE 



These expansion explanations show the parameter 
tables or lists without the service request instruction 
(for those macros including a service request). Byte 
displacement shown at the side of the tables is 
without the service request; considering the service 
request, it is necessary to increase the displacement 
count by 2. 

Where applicable, bytes containing Segment Tags are 
shown. This tag is mandatory in systems having more 
than 64K bytes of storage, and may be implemented 
in smaller systems. A programmer should be aware 
that the showing of Segment Tags in these format 
drawings does not necessarily imply that the tags will 
be in the system he is using. 
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2 
4 
6 

8 
10 
12 
14 
16 
18 

20 
22 
| 24 
26 
28 
30 
32 
34 
36 



PF 



UC 



Table B-1. ALLOCATE Parameter Packet Format 



Request Code 



Return Information 



CS 



CB 



WV 



L1 



CD 



L1 



L2 



L2 



Length 



Return Code 



IA 



IA 



Data Block Count 



Data Block Size 



Data Record Size 



LABI ADR 



LAB2 ADR 



IDENT ADR 



Index Block Size 



Index Key Size 



Data Cylinder Number 



Index Cylinder Number 



Spread Factor 



FT 



IK 



DC 



FO 



IC 



SF 



S TAG LABI 



S TAG LAB2 



STAG IDENT 



Suffixtt 



FL 
CR 
F1 
F3 

BC 

BS 
RS 

L1 

L2 

IA 

IB 

IK 

DC 

IC 

SF 



Byte 


Bit 


Description 







Request code, 1 designates ALLOCATE 


1 




Length, number of words in the parameter packet (10 to 19 words) 


2 





Request complete indicator (C) 

Service request in process 

1 Request complete 


1-7 


Return information 


3 




Return code 


4 





Paired file (PF). PF=1 for paired file. 



t Bytes 6 and 7 reflect which optional parameters are present. If a parameter is not present, as evidenced by the presence of a 
zero in that parameter bit, the corresponding 2-byte word in bytes 16 through 37 is omitted, and those parameters that follow 
are telescoped upward by one word. Four-byte parameters such as IDENT ADR with its segment tag and reserved byte, is 
represented by two bits in the pattern. Both bits (IA) must be set if IDENT ADR is present. 

tt The 2-character suffix for unique file identifier. 
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Byte 



8-11 



12,13 



14,15 



17* 



18,19* 



Bit 



3,4 



4,5 



6,7 



0,1 



Table B-1. ALLOCATE Parameter Packet Format (Continued) 



Description 



Uncataloged (UC). UC=1 for not recording file in the central catalog. 



Contiguous space (CS). CS=1 for contiguous space on each volume. 



Cylinder boundary (CB). CB=1 for space segments starting on cylinder boundary. 



Write verify (WV). WV=1 for write verification of files. 



Common stored data format (CD). CD=1 for common stored data format. 



File type (FT) 

00 Permanent 

01 Scratch 

10 Temporary 

11 Work 



5-7 File organization (FO) 

000 General 

001 Indexed 
010 Relative 
100 Sequential 



LAB1 ADR specified (L1=1)t 



LAB2 ADR specified (L2=1)t 



IDENT ADR specified (IA=1)t 



Index block size specified (IB— 1 ) 



Index key size specified (I K=1 ) 



Data cylinder number specified (DC=1 ) 



Index cylinder number specified (IC=1) 



Spread factor specified (SF=1 ) 



Data block count, number of blocks for data file 



Data block size, size (in bytes) of data block 



Data record size, size (in bytes) of record 



Segment tag for LAB1 ADR (S TAG LAB1) 



LAB1 ADR, address of label information for the primary data file LABDEF1, required if IDENT ADR is not 
specified. 



'Optional parameter. 

tTwo fields are shown on format expansion to accommodate paired files. 
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Byte 



21' 



22,23* 



25* 



26,27* 



28,29* 



30,31* 



32,33* 



34,35* 



36,37* 



Bit 



Table B-1. ALLOCATE Parameter Packet Format (Continued) 



Description 



Segment tag for LAB2 ADR (S TAG LAB2) 



LAB2 ADR, address of label information for a paired file LABDEF2. 



Segment tag for IDENT ADR (S TAG IDENT) 



IDENT ADR, address of file identifier as used by Control Language to identify volumes for use in allocation 



Index block size, size (in bytes) of index file 



Index key size, size (in bytes) of key 



Data cylinder number, cylinder number at which allocation of the data file starts 



Index cylinder number, cylinder number at which allocation of index file starts 



Spread factor, physical record interlace to be used in an indexed data file 



•Optional parameter 
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:. tAf'ANU Kar 


ameter Packet I 


-ormat 










Suffixtt 







Request Code 


Length 


FL 


2 


C 


Return Information 


Return Code 


CR 


4 


PF 


UC 


CS 


lllllilllllllll 


1 1 


L1 


L1 


IA 


IA 


llllillpiilllil 


F1 


6 

8 


Data Block Count 


BC 


10 


:;:;:;::::i:::::':^;:;:;:;j:j;:;j:j:;:;:^ 


STAG LAB1 




12 


LAB1 ADR 


L1 


14 




STAG IDE=NT 




16 


IDENTADR 


IA 



Byte 



6-8 



Bit 



1-7 



0-7 



2,3 



4.5 



Description 



Request code, 2 designates EXPND 



Length, number of words in parameter packet (7 to 9 words) 



Request complete indicator (C) 

Service request in process 

1 Request complete 



Return information 



Return code 



Paired file (PF), PF=1 for paired file 



Uncataloged (UC), UC=1 for uncataloged file 



Contiguous Space (CS), CS=1 if space on each volume is to remain contiguous. 



LABI ADR specified (L1=1)t 



IDENT ADR specified (IA=1)t 



Data block count, number of data blocks to add to the file 



t Byte 5 reflects which optional parameters are present. If a parameter is not present, the corresponding 4-byte field in bytes 10 
through 17 is deleted from the parameter packet and the subsequent parameter words are moved upward. The 4-byte field is 
represented by two bits in byte 5; both bits must be set (or cleared) to reflect the presence of the field. 

tt The 2-character suffix for unique file identifier. 
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Byte 



11* 



12,13* 



15* 



16,17* 



Bit 



Table B-2. EXPAND Parameter Packet Format (Continued) 



Description 



Segment tag for LAB1 ADR (S TAG LAB1) 



LAB1 ADR, address of label information for the file. This parameter is required if IDENT ADR is not specified. 



Segment tag for IDENT ADR (S TAG IDENT) 



IDENT ADR, address of file identifier as used by Control Language. This parameter is required if the file is open 
at the time of expansion. 



♦Optional parameter 
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Table B-3. PURGE Parameter Packet Format 



Suffix tt 






Request Code 


Length 


2 


C 


Return Information 


Return Code 


4 


PF 


UC 




L1 


L1 


IA 


IA 


M£;:;!: ; i-i3tf-:^ 


6 


Hill 




iiiiiiiliiiiiiiiiiiiiiiiiiiiiiiiiffliiillliliiiliiiiWi 


S TAG LAB1 


8 


LAB1 ADR 


10 


iiiiiiiPi^ii^iiii^iiiii^iiSiii^iiiiiS^iiiiiiiiiiiiiiiisiiiiiiiiiiWi 


STAG I DENT 


12 


IDENTADR 



FL 
CR 

F1 
L1 
IA 



Byte 


Bits 


Description 







Request code, 3 designates PURGE 


1 




Length, number of words in parameter packet (5 to 7 words) 


2 





Request complete indicator (C) 

Service request in process 

1 Request complete 


1-7 


Return information 


3 




Return code 


4 





Paired file (PF), PF=1 for paired files 


1 


Uncataloged (UC), UC=1 for uncataloged file 


5 


0,1 


LAB1 ADR specified (L1=1) 


2,3 


IDENT ADR specified (IA=1) 


7* 




Segment tag for LAB1 ADR (S TAG LAB1) 


8,9* 




LAB1 ADR, address of label information for data file. This parameter is required if IDENT ADR is not specified. 


11* 




Segment tag for IDENT ADR 


12,13* 




IDENT ADR, address of file identifier as used by Control Language 



t Byte 5 reflects which optional parameters are present. If a parameter is not present, the corresponding 4-byte field in bytes 6 
through 13 is deleted from the parameter packet and the subsequent parameter words are moved upward. The 4-byte field is 
represented by two bits in byte 5. Both bits must be set to reflect the presence of the field. 

* Optional parameter. 

tt The 2-character suffix for unique file identifier. 
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Table B-4. OPEN Parameter Packet Format 






Request Code 


Length 


2 


C 


Return Information 


Return Code 


4 


cc 


BA 


T J U 


- 


L 


STAG IDENT 


6 


BDTor IDENT 


8 




S TAG LAB ADR 


10 


LAB ADR 


12 




STAG BUF ADR 


14 


BUF ADR 



Suffixtt 

FL 
CR 
BT 

ID 

LB 
BF 



Byte 


Bit 


Description 







Request code, 4 designates OPEN 


1 




Length, number of words in parameter packet (4 to 8 words) 


2 





Request completion indicator (C) 

Service request in process 

1 Request complete 


1-7 


Return information 


3 


0-7 


Return code 


4 





Control character (CC) 

ANSI control characters 

1 Device control characters 


1 


Buffer address (BA) 

No buffer 

1 Buffer present 


2-3 


Type of I/O (T) 

00 Logical 

01 Block 
10 Physical 



t Byte 4 reflects which optional parameters are present. If a parameter is not present, the corresponding 2-byte word in bytes 8 
through 1 5 is deleted from the parameter packet and the subsequent parameter words are moved. 

tt The 2-character suffix for unique file identifier. 



B-12 



Byte 



6,7 



10,11* 



13* 



14,15* 



Bit 



4-5 



Table B-4. OPEN Parameter Packet Format (Continued) 



Description 



Usage (U) 

00 Input 

01 Update 
10 Output 



Rewind (R) 

No rewind 

1 Rewind 



Label (L) 

No label 

1 Label address 



Segment tag for BDT or IDENT (S TAG IDENT) 



BDT or IDENT, address of BDT or address of file identifier 



Segment tag for LAB ADR (S TAG LAB ADR) 



LAB ADR, label address 



Segment tag for BUF ADR (S TAG BUF ADR) 



BUF ADR, buffer address 



"Optional parameter. 
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Suffixt 

























n 


Request Code 


Length 


FL 


2 


C 


Return Information 




Return Code 


CR 


4 




L 


T 




R 




STAG IDENT 


BT 


6 




BDTor IDENT 




ID 



Byte 



1-7 



6,7 



Bit 



3,4 



Description 



Request code, 5 designates CLOSE 



Length, number of words in parameter packet (4 words) 



Request complete indicator (C) 

Service request in process 

1 Request complete 



Return information 



Return code 



Lock(L) 

1 



No lock 
Lock 



Type of I/O (T) 

00 Logical I/O 

01 Block I/O 
10 Physical I/O 



Rewind (R) 

No rewind 

1 Rewind 



Segment tag for IDENT or BDT (S TAG IDENT) 



BDT or IDENT, address of BDT or address, of file identifier 



tThe 2-character suffix for unique file identifier. 
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Table B-6. CLOVE Parameter Packet Format 



Suffix t 


























Request Code 


Length 


FL 


2 


C 


Return Information 


Return Code 


CR 


4 




T 


iiiiiimiim 


STAG IDENT 




6 


BDTor IDENT 


ID 



Byte 



6,7 



Bit 



1-7 



3,4 



Request code, 6 designates CLOVE 



Description 



Length, number of words in parameter packet (4 words) 



Request complete indicator (C) 

Service request in process 

1 Request complete 



Return information 



Return code 



Type of I/O (T) 

00 Logical I/O 

01 Block I/O 



Segment tag for BDT or IDENT (S TAG IDENT) 



BDT or IDENT, address of BDT or address of file identifier 



tThe 2-character suffix for unique file identifier. 
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Suffixt 







iaD 













Request Code 


Length 


FL 


2 


C 


Return Information 


Return Code 


CR 


4 


. 


ELEM 


STAG IDENT 


BT 


6 


IDENT ADR 


ID 


8 


:£:#£;£#:? 


STAG BUFF 




10 


BUFF ADDRESS 


IN 



Byte 



6,7 



10,11 



Bit 



1-7 



5-7 



Request code, 7 designates LABRTN 



Description 



Length, number of words in parameter packet (6 words) 



Request completion indicator (C) 

Service request in process 

1 Request complete 



Return information 



Return code 



Element field (ELEM) 



000 
001 
010 



Name element returned 
Attribute element returned 
Both elements returned 



Segment tag for IDENT (S TAG IDENT) 



IDENT ADR, address of file identifier 



Segment tag for buffer address (S TAG BUFF) 



Address of buffer containing status information 



tThe 2-character suffix for unique file identifier. 
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8 
10 

12 

14 



Table B-8. STATUS and TYPE Macros Parameter Packet Format 



Request Code 



Return Information 



Pointer to File Identifier 



Buffer Address 



Pointer to Byte Counter 



Length 



STAG 



STAG 



STAG 



Suffix* 

FL 
CR 

ID 
BA 

BS 



Byte 



2,3 



6,7 



10, 11 



12 



13 



14,15 



Bit 



0-7 



0-7 



0-15 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



Description 



Request Code: STATUS=40, TYPE=41 ) 



Length, number of words in parameter: 08 



Return Information 



Not used 



Segment Tag 



Pointer to file ID: Address of 8-byte file identifier 



Not used 



Segment Tag 



Buffer Address: first byte address of user-specified buffer area 



Not used 



Segment Tag 



Pointer to Byte Count: address of 2-byte area containing byte count (length of buffer) 



"The 2-character suffix for the unique file identifier. 
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Table B-9. CNTRL/POSITN Macros Parameter Packet Format 



Suffix* 




2 
4 
6 
8 
10 
12 



Request Code 



Return Information 



Sub-Function Code 



Pointer to File ID 



Pointer to Block Number 



Residual Byte Count 



Length 



STAG 



STAG 



FL 
CR 
SF 
ID 

BN 
RC 



Byte 



6,7 



10,11 



12,13 



Bit 



0-7 



0-7 



0-7 



0-7 

7 
6 
5 
0-2 



0-3 

7 
6 




0-7 



0-7 
0-7 



0-7 



0-7 



0-7 
0-7 



0-7 
0-7 



Description 



Request Code: CNTRL=03.POSITN=04 



Length, number of words in the parameter packet, 07 



Return Information 



Sub-Function Code (the indicated bits are set for the function): 

Select Stacker 

Space Line Printer 

Skip Line Printer Form 

Rewind (000) 

Rewind and Unload (001) 

Erase gap (010) 

Backspace Record (100) 

Forward space a record (110) 

Forward space a file (111) 

Backspace a file (101) 

Write End-of-File mark (01 1 ) 

The value of nn when SS, SK, or SP is used 

Beginning of volume 

End of Volume 

SEEK on position 



Segment Tag 



Pointer to File ID: address of 8-byte file identifier in FDT 



Not used 



Segment Tag 



Pointer to Block No.: address of 4-byte block number (applies to POSITN) 



Residual Byte Count: difference between number of bytes requested and number of bytes received. 



"The 2-character suffix for unique file identifier. 
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Table BIO. READ/WRITE Macros Parameter Packet Format 



Suffix* 


















Request Code 


Length 


FL 


2 


Return Information 


CR 


4 


Sub-Function Code 


STAG 


SF 


6 


Pointer to File ID 


ID 


8 




STAG 




10 


Pointer to Block Number 


BN 


12 


Residual Byte Count 


RC 


14 


' 


STAG 




16 


Buffer Address 


BA 


18 


i:3S:iS!::i:i^ 


STAG 




20 


Pointer to Byte Count 


BS 



Byte 


Bit 


Description 





0-7 


Function Code: READ=02, WRITE=01 


1 


07 


Length, number of words in the parameter packet: 1 1 


2,3 


0-7 
0-7 


Return Information 


4 


0-7 

7 

6 

5 

4 

0-3 

0-2 


Sub-Function Code (the indicated bits are set for the function): 

Select Stacker 

Space Line Printer 

Skip Line Printer Form 

EBCDIC=NO 

The value of nn when SK or SP is used 

The value of nn when SS is used 


5 


0-7 


Segment Tag 


6,7 


0-7 
0-7 


Pointer to File ID: address of 8-byte file identifier 


8 


0-7 


Not used 


9 


0-7 


Segment Tag 


10,11 


0-7 
0-7 


Pointer to Block No.: address of 4-byte area containing block number 


12,13 


0-7 
0-7 


Residual Byte Count: difference between number of requested bytes and number of bytes transferred 


14 


0-7 


Not used 


15 


0-7 


Segment Tag 



"The 2-character suffix for unique file identifier. 
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Table B-10. READ/WRITE Macros Parameter Packet Format (Continued) 



Byte 


Bit 


Description 


16,17 


0-7 
0-7 


Buffer Address: first byte address of user specified buffer area 


18 


0-7 


Not used 


19 


0-7 


Segment Tag 


20,21 


0-7 
0-7 


Pointer to Byte Count: address of 2-byte area containing the byte count (length of buffer) 



Table B-1 1 . RESET Macro Parameter Packet Format 



Request Code 



Return Information 



Pointer to File ID 



Length 



STAG 



Suffix* 

FL 
CR 

ID 



L 



Byte 



2,3 



6,7 



Bit 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



Function Code: RESET=31 



Description 



Length, number of words in the parameter packet: 04 



Return Information 



Not used 



Segment Tag 



Pointer to File ID: address of 8-byte file identifier 



*The 2-character suffix for unique file identifier. 
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Table B-12. EXCP Macro Expansion 



The expansion of the EXCP macro does not include a parameter table (LIST=NO is implied) but it may, depending 
on the operands coded in the call, contain executable code for request setup purposes: 



No operands: 



PCB=@register number: 



PCB=symbolic address: 



CP=@register number: 



CP=symbolic address: 



UNORD=symbolic address: 



UNORD=@register number: 



SR 



MOVR 
SR 



LOD 

SR 



STO 
SR 



MOVM 
SR 



MOVB 
SR 



STOB 
SR 



Rn,6 



symbolic address, 6 



6(6),Rn 



symbolic address, 6(6) 



symbolic address, 0(6) 



0(6),Rn 
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Tablo B-13. PCB Macro Parameter Packet Format 



0* 

2 

4 

6 

8 
10 
12 

14 i- 
16 I 

I- 
18 l 



ERP 



Unit Ordinal 



Length 



Return Information 



CP 



Pointer to CP or FC 



Pointer to Current CW 



Status 



Residual Byte Count 



Sense 



Sense 
Sense 



I 



•This macro does not use the standard service request prefix. 



Byte 



2,3 



6,7 



8,9 



10,11 



Bit 



0-7 
0-7 



0-7 
0-7 



3-7 



0-7 



0-7 
0-7 



0-7 
0-7 



0-7 
0-7 



Description 



Unit Ordinal: Device identifier 



Length, number of words in this block excluding Device Ident field 



Return Information (same as for service request macros) 



Error Recovery Flag (ERP) 

= Call system error recovery when an error occurs 

1 = Bypass error recovery 



Not used 



Command Program Flag 

= Next word is address of command program to be executed 

1 = Next word is function code to be executed 



Not used 



Not used 



Pointer to CP or FC 

If CP=0, pointer to command program 
If CP=1 , pointer to function code 



Pointer to Current CW: Address of command word being executed 



Status indication 
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Table B-13. PCB Macro Parameter Packet Format (Continued) 



Byte 


Bit 


Description 


12,13 


0-7 
0-7 


Residual Byte Count: difference between number of bytes requested and number of bytes transferred 


14,15, 
16,17, 
18,19 




Sense bytes: variable number of sense bytes depending on device 
Disc = none 
Unit Record = 2 
Mag Tape = 6 



Table B-14. COMMAND Macro Parameter Packet Format (Basic Data Channel) 



0* 


C 


SL 


SK 




Command Code 


2 


Byte Count 


4 


iISil^ISIlll!I!l^Pil^MSIIIISi^i'§Mfl^^i 


STAG 


6 


Buffer Address 



"This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag (C) 

= No CW follows this one 

1 - Another CW follows 


1 


Suppress Length Check (SL): if it is set, the CP will not be terminated when the transferred 
byte count differs from the specified byte count. Not used when C ™ 0. 


2 


Skip (SK): If it is set, data will not be transferred to memory on a data input operation. 


3-7 


Not used 


8-15 


Command Code: The eight-bit hardware command code (OPCODE). 


2,3 


0-7 


Byte Count: The length of the data buffer (BUFSIZ) in hexadecimal; length must be non-zero 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: the FBA address of the data buffer (BUFADR). 
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Table B-15. COMMAND Macro Parameter Packet Format (DCABLE) 



c 




2 


1 











2 


::;:i::i::::i:;::::::^^ 


STAG 


Buffer Address 



*This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag 

= No CW follows this one 

1 » Another CW follows 


1-7 


Not used 


1 


0-7 


Command Code: DCABLE=21 


2,3 


0-7 


Byte Count: DCABLE=0002 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of buffer into which the disc drive cable address is to be transferred. 
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Table B-16. COMMAND Macro Parameter Packet Format (DCSEEK) 



0** 


C 


*:■:■:•:■:■:■:■:■:-: ■:■:•:■:■:■: -iW:-^ 


2 





2 











4 


4 


I11I1S1B 


lllllllllllllillllilllllllllllilllllllll 


STAG 


6 


Buffer Address 



*This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag 

■ No CW follows this one 

1 = Another CW follows 


1-7 


Not used 


1 


0-7 


Command Code: DCSEEK=20 


2.3 


0-7 


Byte Count: DCSEEK=0004 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of buffer containing cylinder and track numbers. 
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Table B-17. COMMAND Macro Parameter Packet Format (DCSRCH) 



c 


BRS 







8 


Byte Count 




STAG 


Buffer Address 



"This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag 

= No CW follows this one 

1 = Another CW follows 


1-3 


Bit Ring Sync: least-significant three bits of Bit Ring Sync Code 
101 = home address field 
011 = RO count field 
110 = RN count field 


1 


0-7 


Command Code: DCSRCH=08 


2,3 


0-7 


Byte Count: Length of field for which search is being made 
BC = 0005 for home address 
BC = 0009 for count field 


4 


0-7 


Mot used 


5 


0-7 


Segment Tag 


6,7 




Buffer Address: address of buffer containing field data for which search is being made 
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Table B-18. COMMAND Macro Parameter Packet Format (DCREADl 



(1 ) Read with Transfer 



0* 


C 


BRS 




R 





2 


2 


Single Record Byte Count 


4 


::;*:*:*:^ 


STAG 


6 


Buffer Address 


8 






Overall Byte Count 




J 



"This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag 

= No CW follows this one 

1 = Another CW follows 


1-3 


Bit Ring Sync: least-significant three bits of the Bit Ring Sync code: 
001 = data field 
010= key field 
011 = Rq count field 
110= R n count field 
101 = home address field 
100 = control storage data 


4-6 


Not used 


7 


Repeat Flag 

= Execute read command once 

1 = repeat read command until overall byte count is satisfied 


1 


0-7 


Command Code: READ WITH TRANSFER = 02 


2,3 


0-7 


Single Record Byte Count: number of bytes to be transferred in each execution of the read 
command. If R=0 this will be the total number of bytes transferred. 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of the buffer into which the data is to be placed. 


8,9 


0-7 


Overall Byte Count: total number of bytes to be transferred. Only present when R=1 for a 
multi-record read. 



(2) Read Without Transfer 



C 


BRS 


■:• : -■■:■::■:: :■:■:'■:-!:;• ■:■:■:■:■:■:■!■:■:■ :-:■:::-:-:-: ■:• ;■ : :■:■.': -: -:i| : ■:■:*: ■:■:■:■!•: ■ :■: ■ : 





4 


Byte Count 



Command Code = 04 (Bits 0-7 of byte 1 1 
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Table B-19. COMMAND Macro Parameter Packet Format (DCWRIT and DCFWRIT) 



0* 


C 


BRS 




Command Code 


2 


Byte Count 










STAG 


4 


Gap Length 


6 


Buffer Address 



"This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag 

= No CW follows this one 

1 - Another CW follows 


1-3 


Bit Ring Sync: least-significant three bits of the Bit Ring Sync Code 
001 = Data field 

010 = Key field 

011 = R count field 
110 = R n count field 
101 = Home address field 

1 00 -= Control Storage data 


4-7 


Not used 


1 


0-7 


Command Code 
01 = Write 
10= Format Write 


2,3 


0-7 


Byte Count: number of bytes of data to be written (length of buffers). 


4 


0-7 




Gap Length: one's complement of the length of the gap to be written preceding the field 
itself. 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of the buffer containing the data to be written 
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Table B 20. COMMAND Macro Parameter Packet Format (RESTORE) 



•This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag 

= No CW follows this one 

1 = Another CW follows 


1-7 


Not used 


1 


0-7 


Command Code: RESTORE = 22 


2-6 


- 


Not used 



Table B-21. COMMAND Macro Parameter Packet Format (DCJUMP) 



0* 


C 




2 


8 


2 




4 




S TAG 


6 


Address of Next CW 



*This macro does not use the standard service request prefix. 



Byte 


Bit 


Description 








Chain Flag 

= No CW follows this one 

1 = Another CW follows 


1-7 


Not used 


1 


0-7 


Command Code: DCJUMP = 28 


2-4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6.7 


0-7 


Next CW Address: locations of the CW to be executed following this one 



B-29 



Table B-22. WAIT Macro Parameter Packet Format 



Suffix* 






Request Code 


Length 


2 


Return Information 


4 


!l|l||ll|llll|i||||ll|||||l||||;|l||| 


C 




L 


A 


STAG 


6 


Request Block Address (Optional) 



FL 
CR 
BT 
BF 



Byte 


Bit 


Description 





0-7 


Request Code: WAIT-03 


1 


0-7 


Length, number of words in the parameter packet: 3 or 4 


2,3 


0-7 


Return Information 


4 


0-3 


Not used 


4 


Count Flag: C*1 means wait for any request with count option 


5 


Not used 


6 


Wait -all flag (L) 

L=1 means wait for all outstanding requests. 1 .... . _ , . . 

1 When L=0 and A=0, wait is 


7 


Wait -any flag (A) \ ^ specif ic request. 
A=1 means wait is for any outstanding request. 


5 


0-7 


Segment Tag 


6,7 


0-7 


Request Block Address: address of request block for wait-specific. Only present when 
L-0 and A-0. 



'The 2-character suffix for unique file identifier. 
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Table B-23. POST/RPOST Macros Parameter Packet Format 



Request Code 


Length 


Return Information 


^^HlPliiiBS^HiiiHHiiHiiiiilS^Bi^^i 


STAG 


Buffer Address 



Suffix* 

FL 
CR 



Byte 


Bit 


Description 





0-7 


Request Code: POST=43,RPOST=44 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of an 8-byte buffer. This will either contain the information to be 
posted (POST) or will receive the interpreted information from the system (RPOST). 



"The 2-character suffix for unique file identifier. 



Table B»24. SETCOM/GETCOM Macros Parameter Packet Format 



Suffix* 






Request Code 


Length 


2 


Return Information 


4 




STAG 


6 


Buffer Address 



FL 

CR 

IN 



Byte 


Bit 


Description 





0-7 


Request Code: SETCOM=47,GETCOM=48 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of an 8-byte buffer. This will either contain the information to be 
transferred (SETCOM) or will receive information from the system (GETCOM). 



"The 2-character suffix for unique file identifier. 
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Table B-25. ACCEPT Macro Parameter Packet Format 



Suffix* 






Request Code 


Length 


2 


Return Information 


4 


l^^Hiil^^iilllPiliiiM n 


I • 


H 


STAG 


6 


Buffer Address 


8 


liiiiiiii^iiiiiiiiiiiii^iiiiiiiiiiiwiiiiiiiiiiii! 


STAG 


10 




End Address 




1? 


Illiil81liiili^iiiiiilllliillill 


■:■:■:■:■:■: :&: ■::■■::#!■; & ■ £ : ™ &* ii# ■ * 


STAG 















141 NumberAddressJOptional) | 



FL 
CR 
BT 
BF 

EN 
IN 



Byte 



2,3 



6,7 



10,11 



14* 



15* 



16\17* 



Bit 



0-7 



0-7 



0-7 



0-4 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



0-7 



Description 



Request Code: 13 



Length, number of words in the parameter packet: 6 or 8 



Return Information 



Not used 



Number Flag 

■- number not specified (current value of //PAR card pointer will be used) 
1 = //PAR card number is specified in word at displacement 16 



Strip Flag 

= do not strip sequence number field (card cols 73-80) 

1 = strip sequence number field 



Control Header Flag 

= do not include CSDF control header 

1 = include CSDF header 



Segment Tag 



Buffer Address: address of buffer into which data from //PAR card is to be transferred. 



Not used 



Segment Tag 



End Address: address to which program control will be transferred when all //PAR cards 
have been read. 



Not used (optional) 



Segment Tag (optional) 



Number Address (optional): address of ono-word location containing the //PAR card number 



*Last four bytes will only be present when number flag (N) = 1 . 
**The 2-character suffix for unique file identifier. 
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Tablu B-26. MEMLIM Macro Parameter Packet Format 



Request Code 


Length 


Return Information 




STAG 


Buffer Address 



Suffix* 

FL 
CR 

IN 



Byte 


Bit 


Description 





0-7 


Request Code: MEMLIM=46 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: Address of buffer Into which last page address is to be placed. 



*The 2-character suffix for unique file identifier. 



Table B-27. INFORM Macro Parameter Packet Format 






Request Code 


Length 


2 


Return Information 


4 


' '"" " 


STAG 


6 


Count Address 



Suffix* 

FL 
CR 

IN 



Byte 


Bit 


Description 





0-7 


Request Code: INFORM-05 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


4 


0-7 


Not used 


5 


0-7 


Segment Tag 


6,7 


0-7 


Count address: address of a one-word location containing a count of the number of requests 
not known to have completed at this time. 



*The 2-character suffix for unique file identifier. 
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Table B-28. SETIF Macro Parameter Packet Format 






Request Code 


Length 


2 


Return Information 


4 




STAG 


6 


Buffer Address 



Suffix* 

FL 
CR 

IN 



Byte 


Bit 


Description 





0-7 


Request Code: SETIF=45 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


4 


0-7 


Not used 


S 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of a one-byte buffer containing the data to be transferred. 



*The 2-character suffix for unique file identifier. 
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Table B-29. DELAY Macro Parameter Packet Format 






Request Code 


Length 


2 


Return Information 


4 




B 


T 


STAG 


6 


Delay Address 



Suffix* 

FL 
CR 
BT 
IN 



Byte 


Bit 


Description 





0-7 


Request Code; DELAY-04 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


4 


0-5 


Not used 


6 


Break Flag (B) 

= no delay break 

1 = delay to be broken on any service request completion 


7 


Type Flag (T> 

= delay in seconds 

1 = delay in cycles* 


5 


0-7 


Segment Tag 


6,7 


0-7 


Delay Address: address of a one-word buffer containing the duration of the delay in seconds 
or cycles* (see Type Flag). 



"Cycle equals 50.2 milliseconds. 
**The 2-character suffix for unique file identifier. 
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Table B-30. HALT Macro Parameter Packet Format 



Suffix* 



Request Code 



Length 



FL 
CR 



Return Information 



Byte 


Bit 


Description 





0-7 


Request Code: HALT=64 


1 


0-7 


Length, number of words in the parameter packet: 02 


2,3 


0-7 


Return Information 



*The 2-character suffix for unique file identifier. 



Table B-31 . EHALT Macro Parameter Packet Format 



Suffix* 



Request Code 



Length 



FL 
CR 



Return Information 



Byte 


Bit 


Description 





0-7 


Request Code: EHALT=65 


1 


0-7 


Length, number of words in the parameter packet: 02 


2,3 


0-7 


Return Information 



*The 2-character suffix for unique file identifier. 



B-36 



Table B-32. ABEND Macro Parameter Packet Format 



Request Code 


Length 


Return Information 




STAG 




Buffer Address 





"The 2-character suffix for unique file identifier. 



Table B-33. TIME Macro Parameter Packet Format 



Suffix* 

FL 
CR 

IN 



Byte 


Bit 


Description 





0-7 


Request Code: ABEND=75 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of location containing the completion code. 






Request Code 


Length 


2 


Return Information 


4 




STAG 


6 


Buffer Address 



Suffix* 

FL 
CR 

IN 



Byte 


Bit 


Description 





0-7 


Request Code: TIME=73 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of location containing the time 



*The 2-character suffix for unique file identifier. 
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Table B-34. SDATE Macro Parameter Packet Format 



Suffix* 



Request Code 


Length 


Return Information 


Iliil^Sl^^iiiilSiililiiilillll^^B 


D 


STAG 


Buffer Address 



Byte 



2,3 



6,7 



Bit 



0-7 



0-7 



0-7 
7 



0-7 



0-7 



Description 



Request Code: SDATE=74 



Length, number of words in the parameter packet: 04 



Return Information 



Date Flag 

= Calendar date 

1 = Julian date 



Segment Tag 



Buffer Address: address of location containing the date 



"The 2-character suffix for unique file identifier. 



FL 
CR 
BT 
IN 



Table B-3S. JDATE Macro Parameter Packet Format 



Suffix* 



Request Code 


Length 


Return Information 




D 


STAG 


Buffer Address 



FL 
CR 
BT 
IN 



Byte 


Bit 


Description 





0-7 


Request Code: JDATE=66 


1 


0-7 


Length, number of words in the parameter packet: 04 


2,3 


0-7 


Return Information 


4 


7 


Date Flag 

= Calendar date 

1 = Julian date 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer address: address of location containing the date 



*The 2-character suffix for unique file identifier. 
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Table B-36. CONSOLE Macro Parameter Packet Format 



Suffix" 






Request Code 


Length 


2 


Return Information 


4 




STAG 


6 


Buffer Address 


8 


^^^^SI^M^^S^H^^^^^^^^^S 




STAG 




10 


Reply Address 



FL 
CR 

BF 

IN 



Byte 


Bit 


Description 





0-7 


Request Code: CONSOLE=01 


1 


0-7 


Length, number of words in the parameter packet: 04 (without reply) or 06 (with reply) 


2,3 


0-7 


Return Information 


5 


0-7 


Segment Tag 


6,7 


0-7 


Buffer Address: address of location containing message 


9 


0-7 


Segment Tag 


10,11 


0-7 


Reply Address: address of location containing reply message. 



*The 2-character suffix for unique file identifier. 



B-39 



C. ERROR RECOVERY 



INTRODUCTION 

Of the various classes of possible errors associated 
with a service request, the operating system's error 
recovery program is concerned with only one 
particular class: the input/output hardware 
malfunctions. Attempted recovery from these 
input/output hardware malfunctions will be 
performed for all levels of input/output coding by 
default; however, at the physical level it may be 
bypassed if specified. 

If an error proves to be irrecoverable, information 
describing the error is returned to the user's request 
or command block (Table C-1) and then, normally, 
the job is aborted. However, if the operand, 
ERRCOMP=YES had been coded in the original 
request, control is returned so that the user may 
either ignore the error or attempt to process it 
himself. 

In addition to its basic task of attempting to recover 
from errors, the error recovery program is also 
responsible for handling certain exceptional non-error 
situations, such as EOF detection and indication. 

TYPES OF ERROR 

The following major categories of error are handled 
by the error recovery program. 

INTERVENTION REQUIRED 

When operator intervention is required, a console 
message is issued. Once the operator has serviced the 
device, he responds to the message indicating either 
to continue processing or to return control to the 
user. The MRX/OS Messages manual contains the 
operator console messages. 



ERRORS REQUIRING RETRIES 

Input/output requests completed but including 
specific types of errors are retried a given number of 
times. If the error persists, a message is typed on the 
operator's console. The operator response indicates 
either to retry the request another specific number of 
times or to return the error condition indication to 
the user program. If one of the retries succeeds, a 
normal completion indication is returned to the user 
program as though no error had occurred. 

CONDITIONS OF UNCERTAINTY 

There are certain error conditions where the error 
recovery program is unable to perform accurate error 
recovery, or any error recovery at all; for example, 
not being sure where magnetic tape is positioned. 

Although the error recovery program checks all 
defined hardware conditions, it is not inconceivable 
that an undefined condition from a non-supported 
hardware device might arise; in this case the error 
recovery program is unable to process it. 

With regard to the first example, it should be noted 
that although the error recovery program checks all 
defined hardware conditions, it is not inconceivable 
that an undefined condition might arise; in this case 
the error recovery program is unable to process it. 

When error conditions of this kind occur, a message is 
typed on the operator's console. If the message 
requires a response and the operator chooses to 
continue, the user may either gain or lose 
information. If the message does not require a 
response, the request is routed back to the user with a 
return code. 
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IMMEDIATE IRRECOVERABLE CONDITIONS 

An example of an error so classified is that of 
magnetic tape running off the end of the reel. In 
situations such as this, a console message is typed and 
the request is routed back to the user with a return 
code. 



CONDITIONS 
RECOVERY 



THAT DO NOT REQUIRE 



Certain conditions routed to the error recovery 
program are considered to be normal completions and 
do not require the issuance of any return codes or 
error messages. Two examples are these : 

• a parity error while spacing magnetic tape 
(no recovery is needed because tape is 
properly positioned) 

• detection of an end-of-file condition 



ERROR LOGGING 

Error logging is an integral part of the operating 
system. The error log file, which is built at system 
generation time, consists of forty-byte records (Table 
C-2). 

Records of error conditions and retries are 
maintained in the two error flag bytes and two error 
counters, respectively (located in the extension area 
of each unit table entry). The bits of the error flag 
bytes represent the error conditions that can occur. If 
multiple errors occur, bits are set as the error 
conditions are detected. 

The error counters are incremented by 1 whenever a 
retry error condition occurs. Each error counter can 
contain more than one error condition. 
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Table C-1. I/O Error Recovery Information 



Condition 


Hexadecima 

Status 

Completion 

Code 


FDT 

Return 

Informatior 


PCB/Request 

Block Return 

Information 

Field 


Message 

Code 

Displayed 

On Console 


Console 

Message 

Reply 


No. of 
Retries* 


Must 
File be 
Reset 


Error Log 
Record 
Written 


EOA on this disc request 








A000 


- 


- 





N 




Channel 1 2 on the printer carriage 
control tape 








A001 


- 


- 





N 


N 


This request was not processed be- 
cause an exception condition 
occurred on a previous request and 
the file has not been reset 




Old 


C001 









Y 


N 


Disc EOF 





0002 


A002 


- 


- 





Y 


N 


Unit down 


5002 


0002 


C002 


002 


- 





Y 


N 


Card reader EOF 





0003 


A003 


- 


- 





Y 


N 


Invalid function code in command 
program 


5003 


- 


C003 


- 


- 





- 


N 


Channel 9 on the printer carriage 
control tape 








A004 




- 





N 


N 


A Remove request removed this 
request 


5004 


— 


C004 


- 


- 





- 


N 


Length error. A record was read 
which was longer than the buffer 
space provided for it 








C005 


— 


— 





N 


N 


Tape mark sensed on any Read 
operation not including Search 
command 





0006 


A006 


— 


— 





Y 


N 


An ASKATT request is being re- 
jected because an ASKATT is 
already pending against the device 


5006 


— 


C006 


— 


— 





— 


N 


Error status indication returned 
from an I/O operation 


5010 


0010 


C010 


- 


- 





- 


N 


Operation timed out 


5011 


0011 


C011 


011 


N/Y 


1 


Y 


Y 


Unsolicited attention set 


5012 


0012 


C012 


012 


- 


1 


Y 


N 


Bad I/O status indication from Seek 
or Restore 


5013 


0013 


C013 


- 


- 





Y 


N 


No error recovery for device 


503F 


003F 


C03F 


- 


- 





Y 


N 


Invalid function code in BIO macro 


5020 





C020 


- 


- 





N 


N 


Invalid block number 


5021 





C021 


- 


- 





N 


N 


Invalid byte count 


5022 





C022 


- 


- 





N 


N 


Invalid CNTRL request 


5023 





C023 


- 


- 





N 


N 


NoFDT 


5024 


- 


C024 


- 


- 





N 


N 


Usage error 


5025 





C025 


- 


- 





N 


N 


Operation to locked file 


5026 





C026 


- 


- 





N 


N 


Invalid sequence of operations to 
a device 


5027 





C027 


- 


- 





N 


N 


Subfunction field error 


5028 





C028 


- 


- 





N 


N 


Invalid position (to magnetic tape 
file that is not maintaining block 
numbers) 


5029 





C029 


— 


— 





N 


N 


EOF on a read to a bypassed file 








A02A 


- 


- 





N 


N 


Invalid unit ordinal on privileged 
I PIO request 


5030 




C030 


- 


- 





- 


N 



'Number of retries automatically performed by Error Recovery before completion is declared. 
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Table C-1. I/O Error Recovery Information (Continued) 



Condition 


Hexadecimal 

Status 

Completion 

Code 


FDT 

Return 

nformation 


PCB/Request 

Block Return 

Information 

Field 


Message 

Code 

Displayed 

On Console 


Console 

Message 

Reply 


No. of 
Retries 


Must 
File be 
Reset 


Error Log 
Record 
Written 


DISC 
Timeout 


5041 


0041 


C041 


041 





10 


Y 


Y 


Command reject 


5042 


0042 


C042 


042 


- 





Y 


N 


Disc write current 


5043 


0043 


C043 


043 


- 





Y 


Y 


Seek incomplete 


5044 


0044 


C044 


044 


- 


10 


Y 


Y 


Not on line 


5045 


0045 


C045 


045 


Y/N 


1 


Y 


N 


File unsafe 


5046 


0046 


C046 


046 


- 





Y 


Y 


Pack change 


5047 


0047 


C047 


047 


- 





Y 


N 


Status not valid 


5048 


0048 


C048 


048 


- 





Y 


Y 


Command early 


5049 


0049 


C049 


049 


- 





Y 


Y 


Unsolicited Attention 


504A 


004A 


C04A 


04A 


- 


1 


Y 


N 


Catastrophic error 


504B 


004 B 


C04B 


04B 


Y/N 





Y 


Y 


Missed window 


504C 


004C 


C04C 


CMC 


- 


10 


Y 


Y 


IFA window 


504D 


004D 


C04D 


04D 


- 


10 


Y 


Y 


Track boundary 


504 E 


004E 


C04E 


04E 


- 


10 


Y 


N 


Read Write terminate 


504 F 


004 F 


C04F 


04F 


- 


10 


Y 


Y 


Burst check 


5050 


0050 


C050 


050 


- 


10 


Y 


Y 


Lost data 


5051 


0051 


C051 


051 


- 


10 


Y 


Y 


No sync compare 


5052 


0052 


C052 


052 


- 


10 


Y 


Y 


Write operation issued to a drive 
in read only mode 


5053 


0053 


C053 


053 


Y/N 


1 


Y 


N 


End of cylinder 


5054 


0054 


C054 


054 


- 


10 


Y 


Y 


Busy 


5055 


0055 


C055 


055 


- 


10 


Y 


Y 


Invalid seek address 


5056 


0056 


C056 


056 


- 





Y 


N 


Search failed (arm mispositioned) 


5058 


0058 


C058 


058 


- 


5 


Y 


Y 


Search failed (no record found) 


5059 


0059 


C059 


059 


- 


5 


Y 


N 



PRINTER 
Command reject 


5064 


0065 


C064 









Y 


N 


I/O Channel error 


5065 


0065 


C065 


065 


Y/N 


1 


Y 


Y 


Data check 


5066 


0066 


C066 


- 


- 





Y 


Y 


Not ready 


5067 


0067 


C067 


067 


Y/N 


1 


Y 


N 


Bus out check 


5069 


0069 


C069 


069 


Y/N 


1 


Y 


Y 


Catastrophic error 


506A 


006A 


C06A 


06A 


Y/N 


1 


Y 


Y 


Both channel 9 and 12 on the 
printer carriage control tape 








A06B 


— 


— 





N 


N 
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Table C-1. I/O Error Recovery Information (Continued) 



Condition 


Hexadecimal 

Status 
Completion 

Code 


FDT 

Return 

Information 


PCB/Request 

Block Return 

Information 

Field 


Message 

Code 

Displayed 

On Console 


Console 

Message 

Reply 


No. of 
Retries 


Must 
File be 
Reset 


Error Log 
Record 
Written 


CARD READER 
Catastrophic error 


5070 


0070 


C070 


070 


Y/N 





Y 


N 


Command reject 


5071 


0071 


C071 


- 


- 





Y 


N 


Not ready 


5072 


0072 


C072 


072 


Y/N 




Y 


N 


Busy 


5073 


0073 


C073 


- 


- 


10 


Y 


Y 


Feed check or jam 


5074 


0074 


C074 


074 


Y/N 




Y 


Y 


Read check 


5075 


0075 


C075 


075 


Y/N 




Y 


Y 


Data check (illegal EBCDIC char.) 


5076 


0076 


C076 


076 


Y/N 




Y 


N 


Time out 


5077 


0077 


C077 


- 


- 


10 


Y 


Y 


Unsolicited attention 


5078 


0078 


C078 


078 


- 




Y 


N 


Initial selection error 


5079 


0079 


C079 


- 


- 


10 


Y 


Y 



CARD READER PUNCH 
Catastrophic error 


5080 


0080 


C080 


080 


Y/N 





Y 


N 


Command Reject 


5081 


0081 


C081 


- 


- 





Y 


N 


Not ready 


5082 


0082 


C082 


082 


Y/N 




Y 


N 


Busy 


5083 


0083 


C083 


- 


- 


10 


Y 


Y 


Feed check or jam 


5084 


0084 


C084 


084 


Y/N 




Y 


Y 


Data check (illegal EBCDIC char.) 


5085 


0085 


C085 


085 


Y/N 




Y 


N 


Read check 


5086 


0086 


C0S6 


086 


Y/N 




Y 


Y 


Time out 


5087 


0087 


C087 


- 


- 


10 


Y 


Y 


Unsolicited attention 


5088 


0088 


C088 


088 


- 




Y 


N 


Initial selection error 


5089 


0089 


C089 


- 


- 


10 


Y 


Y 


Punch check 


508A 


008A 


C08A 


08A 


Y/N 




Y 


Y 



MAGNETIC TAPE 
Command reject (read reverse) 


50 A 1 


00A1 


C0A1 


„ 








Y 


N 


Command reject (protected tape) 


50A1 


00A1 


C0A1 


0A1 


- 


) 


Y 


N 


Intervention required (without 
equipment check) 


50A2 


00A2 


C0A2 


0A2 


Y/N 


1 


Y 


Y 


Intervention required (with 
equipment check) 


50A3 


00A3 


C0A3 


0A3 


— 





Y 


Y 


Bus out check (on command) 


50A4 


00A4 


C0A4 


0A4 


Y/N 


10 


Y 


Y 


Bus out check (on data) 


50A5 


00A5 


C0A5 


0A5 


Y/N 


10 


Y 


Y 


Equipment check (Read Write reg.) 


50A6 


00A6 


C0A6 


0A6 


Y/N 


10 


Y 


Y 


Equipment check (Write register) 


50A7 


00A7 


C0A7 


0A7 


Y/N 


1 


Y 


Y 


Equipment check (Read register) on 
data 


50A8 


00A8 


C0A8 


0A8 


Y/N 


1 


Y 


Y 


Equipment check (Read register) 
on command 


50A8 


00A8 


C0A8 


0A8 


— 





Y 


Y 


Equipment check (Delay register) 
on data 


50A9 


00A9 


C0A9 


0A9 


Y/N 


1 


Y 


Y 
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Table C-1. I/O Error Recovery Information (Continued) 



Condition 


Hexadecimal 
Status 

Completion 
Code 


FDT 

Return 

Information 


PCB/Request 

Block Return 

Information 

Field 


Message 

Code 

Displayed 

On Console 


Console 

Message 

Reply 


No. of 
Retries 


Must 
File be 
Reset 


Error Log 
Record 
Written 


Equipment check (Delay register) 
on command 


50A9 


00A9 


C0A9 


0A9 


- 





Y 


Y 


Data check (Write) 


50AA 


00AA 


COAA 


OAA 


Y/N 


10-5 


Y 


Y 


Data check (Write File Mark) 


50AB 


00AB 


COAB 


OAB 


Y/N 


10 


Y 


Y 


Data check (multiple track error 
on read) 


50AC 


OOAC 


COAC 


OAC 


Y/N 


10 


Y 


Y 


Data check (single track error on 
read) Includes preamble and post - 
amble errors 


50AD 


OOAD 


CO AD 


OAD 


Y/N 


10 


Y 


Y 


Data check (phase track in error 
and VRC without Read Write 
register error) 











— 







N 


Y 


Data check (Erase) 


50 A E 


OOAE 


COAE 


OAE 


Y/N 


1 


Y 


Y 


Over run 


50 A F 


OOAF 


COAF 


OAF 


Y/N 


10 


Y 


Y 


Word count zero (Write Command 
Counts 0) 


50B0 


00B0 


COBO 


OBO 


- 


10 


Y 


Y 


Not capable 


50B1 


00B1 


C0B1 


0B1 


Y/N 


1 


Y 


N 


Backspace into BOT 





00B2 


A0B2 


- 


- 





Y 


N 


Reverse Read command at BOT 


50B4 


00B4 


C0B4 


- 


- 





Y 


N 


EOT during any write operation 





0OB5 


A0B5 


- 


- 





Y 


N 


Unsolicited attention 


50B6 


00B6 


C0B6 


0B6 


Y/N 


1 


Y 


N 


Time out 


50B7 


00B7 


C0B7 


0B7 


- 





Y 


Y 


Undefined IOC error 


50B8 


00B8 


C0B8 


0B8 


N 





Y 


N 


Internal recovery error No. 1* 


50B9 


00B9 


C0B9 


0B9 


N 


10 


Y 


Y 


Internal recovery error No. 2* 


50BA 


OOBA 


COBA 


OBA 


N 





Y 


Y 


Internal recovery error No. 3* 


50BB 


OOBB 


COBB 


OBB 


N 





Y 


N 


ISS channel error 


50E1 


00E1 


C0E1 


0E1 


Y/N 


10 


Y 


Y 


Wrong address-in channel error 


50E2 


00E2 


C0E2 


0E2 


Y/N 


10 


Y 


Y 


Control check channel error 


50E3 


00E3 


C0E3 


0E3 


Y/N 


10 


Y 


Y 


Transmission check channel error 


50E4 


00E4 


C0E4 


0E4 


Y/N 


10 


Y 


Y 


Zero byte count 


50E5 


00E5 


C0E5 


- 


— 





Y 


N 



"Catastrophic error. 
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Table C-2. Error Log Record 





2 

4 

6 

8 

10 

12 

14 

16 

18 

20 

22 

24 

26 

28 

30 

32 

34 

36 

38 



ID 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


DATE/TIME 


PROCESSOR 


DEVICE ADDR 


CMD IN ERROR 


STATUS 


STATUS 


ER FLAG BYTE 


ER FLAG BYTE 1 


ERROR COUNTER 1 


ERROR COUNTER 2 


ERROR COUNTER 3 OR CYLINDER 


ERROR COUNTER 4 OR HEAD 


VOL ID 


VOL ID 


VOL ID 


VOL ID 


VOL ID 


VOL ID 


SENSE 


SENSE 


SENSE 


SENSE 


SENSE 


SENSE 






RECORD SEQ. NUMBER 


RECORD SEQ. NUMBER 



Bytes 




Mnemonics 



ID 



Description 

Identification of the record. The value of this field is as follows: 
Hex Value Explanation 

01 from disc error recovery 

02 from tape error recovery 

03 from card reader error recovery 

04 from card reader punch error recovery 

05 from printer error recovery 

06 from logical communications error recovery 

07 from error correction code feature (optional) 



1-12 



DATE/TIME 



The date and time which are supplied by the Exec are in a binary format as follows: 

Byte Explanation 

1 unused 

2 year 

3 month 

4 day 

5 hour 

6 minutes 
7-10 seconds 

11-12 hardware clock 
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Bytes 



13 



Mnemonics 



PROCESSOR 



Table C-2. Error Log Record (Continued) 

Description 

Processor state which the device uses. The processor codes are as follows: 
Hex Code Processor 



08 


zero 


04 


one 


02 


two 


01 


three 



14 


DEVICE ADDR 


15 


CMD IN ERROR 


16-17 


STATUS 


18-19 


ER FLAG BYTE0&1 



The physical device address. The physical device address for disc is the cable address (not the 
plug address). 

The command code that the driver is attempting to execute when the error condition occurs. 

The two bytes of hardware status indication. 

Flag bits set by error recovery modules when the different error conditions occur. The two 
flag bytes are described as follows: 

Magnetic Tape 



Flag Byte 




Bit 


Explanation 





intervention required 


1 


bus out check 


2 


equipment check (register parity) 


3 


equipment check (internal counter) 


4 


data check 


5 


over run 


6 


word count zero 


7 


preamble/postamble error 


Flag Byte 1 




Bit 


Explanation 





timeout error 


1 


ISS channel error 


2 


wrong address-in channel error 


3 


control check channel error 


4 


transmission check channel error 


5-7 


unused 




Disc 


Flag Byte 




Bit 


Explanation 





command early 


1 


timeout 


2 


disc arm mispositioning 


3 


unused 


4 


read/write terminate 


5 


catastrophic error 


6 


lost data 


7 


no sync compare 
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Table C-2. Error Log Record (Continued) 

Bytes Mnemonics Description 



Flag Byte 1 




Bit 


Explanation 





third revolution sync find 


1 


seek incomplete 


2 


file unsafe 


3 


missed window 


4 


burst check 


5 


end of cylinder 


6 


disc write current 


7 


busy 



Card Reader and Reader Punch 



Flag Byte 

Bit Explanation 






timeout 


1 


busy 


2 


ISS channel error 


3 


catastrophic error 


4 


punch check 


5 


command reject 


6 


read check 


7 


card feed check or jam 


Flag Byte 1 




Bit 


Explanation 



0-7 unused 

Printer 
Flag Byte 

Bit Explanation 

timeout 

1-4 unused 

5 bus out check 

6 data check 

7 invalid sense information 

Flag Byte 1 

Bit Explanation 



ISS error 

1 unused 

2 wrong address in initial selection or address/status parity 

3 no request in SIO poll sequence request 

4 control check 

5 data transmission check 
6-7 unused 

Note: The printer hardware status bytes that are written in the error log file represent 
all of the conditions that occurred while printer error recovery was in progress 
for a given error. Therefore, if a channel error occurs during recovery procedures, 
it will appear in the two hardware status bytes. 
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Table C-2. Error Log Record (Continued) 



Bytes 



Mnemonics 



Description 



20 



ERROR COUNTER 1 



21 



ERROR COUNTER 2 



22 ERROR COUNTER 3 

or CYLINDER 



23 ERROR COUNTER 4 

or HEAD 



24-29 VOLID 
30-35 SENSE 

36-37 
38-39 



The following errors use Counter 1 : 

1 . Card Reader and Card Reader Punch Error Recovery error conditions. 

2. Disc Error Recovery error conditions except search failures. 

3. Magnetic Tape Error Recovery for user request error condition. 

The following errors use Counter 2: 

1 . Disc Error Recovery for a search failure. 

2. Magnetic Tape Error Recovery for recording the number of erase operations 
performed during the recovery of a write operation. 

Error Counter 3 is incremented by the Magnetic Tape Error Recovery for positioning 
errors. Or, the disc's cylinder number is extracted from the seek argument of the first 
command word in a command program. If the first command word is not a seek, the 
cylinder number is not supplied. 

Magnetic Tape Error Recovery uses Counter 4 as a record counter. Bits 0-3 are used 
when positioning forward and bits 4-7 are used when positioning backward. The 
disc's head number is extracted from the seek argument of the first command word 
in a command program. If the first command word is not a seek, the head number is 
not supplied. 

Volume ID. This field applies only to disc. 

From one to six sense bytes depending on the type of device. See the associated hardware 
specification for the bit positions and their meanings. 

Unused. 

Record sequence number. 
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D. GAP SPECIFICATIONS 



Table of Gap specifications to be used with the COMMAND/OPCODE=DCWRIT macro when working 
with fixed record lengths (and no key fields). 



Record Size 
in Bytes 



3521 - 


7294 


2299- 


3520 


1694- 


2298 


1333- 


1693 


1093- 


1332 


922- 


1092 


794- 


921 


695- 


793 


616- 


694 


551 - 


615 


497- 


550 


451 - 


496 


412- 


450 


378- 


411 


348- 


377 


322- 


347 


299- 


321 


277- 


298 


259- 


276 


242- 


258 


227- 


241 


212- 


226 


200- 


211 


188- 


199 


177- 


187 


167- 


176 


158- 


166 


149- 


157 


140- 


148 


133- 


139 


126- 


132 


119 — 


125 


113- 


118 


107- 


112 


101 - 


106 


95- 


100 


81 - 


94 


62- 


80 


46- 


61 


33- 


45 


23- 


32 


13- 


22 


0- 


12 



Number of 
Records in Track 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 

37-39 
40-44 
45-49 
50-54 
55-59 
60-64 
65-73 



GAP (Inverted Hex) 



None 

67 

9C 

B6 

C5 

DO 

D7 

DC 

E1 

E4 

E7 

E9 

EB 

ED 

EE 

F0 

F1 

F2 

F3 

F3 

F4 

F5 

F5 

F6 

F6 

F7 

F7 

F8 

F8 

F9 

F9 

F9 

F9 

FA 

FA 

FA 

FB 

FC 

FD 

FE 

FE 

FE 

FF 



D-1 



rv- 


F 


C 


C 


H 


H 


F 
B 


S 
B 


1 
C 


B 
C 


\r 


F 


C 


C 


H 


H 


R 


K 


D 


D 


F 
B 


S 
B 


C 


B 
C 
- \t 


















F 
B 


S 
B 


1 
C 


B 
C 


t 


F 


C 


C 


H 


H 


R 


K 


D 





F 
B 


S 
B 


C 


B 
C 














F 
B 


S 
B 


1 
C 


B 
C 












F 
B 


S 

B 


1 
C 


B 
C 




G4 


HOME 

ADDRESS 

5+4 (BURST) 

BYTES 


CM 
CD 


RO COUNT 

FIELD 

9+4 (BURST) 

BYTES 


CM 

a 


RO DATA 

FIELD 

VARIABLE 

(8+4) TO 

FULL TRACK 




COUNT FIELD 

9+4 (BURST) 

BYTES 


\ 

CM 

CO 


KEY 

FIELD 

TO 255 

BYTES 


■N 

CM 
CS 


DATA 
FIELD 
7294 
(MAX) 
BYTES 


— v- 

GO 



___ — - - GAP BIT CONFIGURATION — -._____ 



ONES 



11111111 



VARIABLE AREA 

\ 

ONES 



11111111 

N 



ONES 



11111111 



VFO AREA 5 BYTES 



■v 



ZEROS 





N — 



ZEROS 







ONES 



11111111 



AM AREA 
2 BYTES 



ONES 
5 BITS MISSING 
CLOCK PULSES 

11111111 



ONES 
5 BITS MISSING 
CLOCK PULSES 

i fT?~TT 1 i 



BIT RING 

SYNC AREA 

1 BYTE 



SEE 
TRACK 
FORMAT 



F = FLAG BYTE 

CC = CYLINDER NUMBER IN BINARY 

HH = HEAD NUMBER IN BINARY 

R = TRACK RECORD NUMBER IN BINARY 

K = KEY FIELD LENGTH IN BINARY 

DD = DATA FIELD LENGTH IN BINARY 

FB = FIRST (CYCLIC BURST) BYTE 

SB = SECOND (CYCLIC BURST) BYTE 

IC = INDICATOR BYTE 

BC = BIT COUNT BYTE 

GO = 41 BYTES + 0.043 X(K L + D L )* 

G2 = 41 BYTES 

G4 = 73 BYTES 

* BURST CHECK BYTES NOT INCLUDED 



SYNC BYTE CONFIGURATIONS 


























HA 
SYNC 
BYTE 




RO COUNT 
SYNC 
BYTE 




RO DATA 
SYNC 
BYTE 




R N COUNT 
SYNC 
BYTE 




KEY 
SYNC 
BYTE 




R N DATA 
SYNC 
BYTE 


"10 
110 1 


"10 
10 11 


910 
10 1 


"10 
1110 


N>10 
10 10 


9l0 
10 1 



m 

g 

C/> 

o 

H 

> 
O 

Tl 
O 
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F. INDEX-BLOCK SIZE FOR INDEXED FILES 



There is a minimum index block size for every 
indexed file depending on key size and file size. The 
user may utilize any index block size larger than the 
minimum, if he has memory space for a larger index 
block. The larger the index block the better retrieval 
becomes on random processing. If the user goes 
below the minimum index block size there is the 
possibility of not being able to create the file size as 
planned. 

When planning the creation of indexed files, the user 
must decide whether he wants to process the 
directory-directory, which resides on mass storage, in 
a main memory buffer. This option speeds up random 
processing, but requires extra space for the buffer. If 
the mode of processing is with a main-memory buffer 
there is a well-defined optimum index block size 
which .minimizes memory space for the index buffer 
and directory-directory buffer. 

Once the user has determined his mode of processing, 
Table F-1 is used to determine minimum-keys/block 
and Table F-2 is used to determine optimum 
keys/block. Note that in using Table F-1 and Table 
F-2, the larger of the two values in the file size is the 
determining factor. Also note that these tables were 
computed for consistency for maximum key size and 
one million records as the upper limit. There will be 
some index block sizes generated that exceed one 
track in number of bytes. This exceeds the system 
limit for block sizes. The user will have to choose a 
smaller key size or smaller file size. 

The keys/block is entered in the Control Language 
//DEFINE statement along with key size. The 
corresponding minimum or optimum index block size 
can be calculated from Table F-3. The resulting index 
block size is then entered in the COBOL source 
program via the INDEX-BLOCK Clause. 



If the user has determined to calculate the optimum 
keys/block and optimum index block size, Table F-4 
is used to calculate the number of bytes for the 



is used to calculate the number of bytes for the 
buffer for the directory-directory 



ma in -memory 
entries. 



The user must be careful not to exceed the file 
maximum at creation time when using the optimum 
block size — when he utilizes the main-memory 
buffer to hold the directory-directory entries for 
random processing, the buffer would not be able to 
hold all the entries, thus writing over the user 
program. Thus, when choosing an index block size 
other than the optimum and the main-memory buffer 
is used to process the directory-directory entries, the 
buffer size should be the size of the index block, as 
the system checks for overflow at creation time. 

If the user wishes to calculate keys/block based on a 
different file maximum than given in Tables F-1 and 
F-2, the following algorithms, along with Table F-5, 
can be used to compute minimum and optimum 
keys/block. The constants Ko and Km are taken from 
Table F-5 based on key size. 



Optimum (OKB) 



Minimum (MKB) 



■f^Js 



^s,} 



NOTE: 



FS = Maximum File Size 



Round up if result not 
whole integer. 
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Table F-1. Minimum Kays/Block 





Key Ki7fi in Bytes 




















11 


16 


21 


26 


36 


51 


Blocks in File 




















to 


to 


to 


to 


to 


to 




2 


3 


4 


5 


6 


7 


8 


9 


10 


15 


20 


25 


35 


50 


100 


- 5,000 


13 


14 


14 


14 


15 


15 


15 


15 


15 


16 


16 


16 


16 


17 


17 


5,000- 10,000 


16 


17 


18 


18 


18 


19 


19 


19 


19 


20 


20 


20 


21 


21 


21 


10.000-15,000 


19 


20 


20 


21 


21 


21 


22 


22 


22 


23 


23 


23 


23 


24 


24 


15,000-20,000 


20 


21 


22 


23 


23 


23 


24 


24 


24 


25 


25 


26 


26 


26 


26 


20,000 - 25,000 


22 


23 


24 


24 


25 


25 


25 


26 


26 


27 


27 


27 


28 


28 


28 


25,000 - 30,000 


23 


24 


25 


26 


26 


27 


27 


27 


28 


28 


29 


29 


29 


30 


30 


30,000 - 35,000 


25 


26 


27 


27 


28 


28 


28 


29 


29 


30 


30 


31 


31 


31 


32 


35,000 - 40,000 


26 


27 


28 


28 


29 


29 


30 


30 


30 


31 


32 


32 


32 


33 


33 


40,000 - 45,000 


27 


28 


29 


30 


30 


31 


31 


31 


31 


32 


33 


33 


34 


34 


34 


45,000 - 50,000 


28 


29 


30 


31 


31 


32 


32 


32 


33 


34 


34 


34 


35 


35 


36 


50,000 - 60,000 


29 


31 


32 


32 


33 


34 


34 


34 


35 


36 


36 


37 


37 


37 


38 


60,000 - 70,000 


31 


32 


34 


34 


35 


35 


36 


36 


36 


37 


38 


38 


39 


39 


40 


70,000 - 80,000 


32 


34 


35 


36 


36 


37 


37 


38 


38 


39 


40 


40 


41 


41 


42 


80,000 - 90,000 


34 


35 


36 


37 


38 


38 


39 


39 


40 


41 


41 


42 


42 


43 


43 


90,000 - 1 00,000 


35 


36 


37 


38 


39 


40 


40 


41 


41 


42 


43 


43 


44 


44 


45 


100,000-125,000 


37 


39 


40 


41 


42 


43 


43 


44 


44 


45 


46 


47 


47 


48 


48 


1 25,000 - 1 50,000 


40 


41 


43 


44 


45 


45 


46 


46 


47 


48 


49 


49 


50 


51 


51 


150,000- 175,000 


42 


44 


45 


46 


47 


48 


48 


49 


49 


50 


51 


52 


53 


53 


54 


175,000-200,000 


44 


46 


47 


48 


49 


50 


50 


51 


51 


53 


54 


54 


55 


56 


• 56 


200,000 - 250,000 


47 


49 


51 


52 


53 


54 


54 


55 


55 


57 


58 


58 


59 


60 


61 


250,000 - 300,000 


50 


52 


54 


55 


56 


57 


58 


58 


59 


61 


61 


62 


63 


64 


64 


300,000 - 350,000 


52 


55 


57 


58 


59 


60 


61 


62 


62 


64 


65 


65 


66 


67 


68 


350,000 - 400,000 


55 


57 


59 


61 


62 


63 


63 


64 


65 


67 


68 


68 


69 


70 


71 


400,000 - 450,000 


57 


60 


62 


63 


64 


65 


66 


67 


67 


69 


70 


71 


72 


73 


74 


450,000 - 500,000 


59 


62 


64 


65 


67 


68 


68 


69 


70 


72 


73 


74 


74 


75 


76 


500,000 - 600,000 


63 


66 


68 


69 


71 


72 


73 


73 


74 


76 


77 


78 


79 


80 


81 


600,000 - 700,000 


66 


69 


71 


73 


74 


75 


76 


77 


78 


80 


81 


82 


83 


84 


85 


700,000 - 800,000 


69 


72 


74 


76 


78 


79 


80 


81 


81 


84 


85 


86 


87 


88 


89 


800,000 - 900,000 


72 


75 


77 


79 


81 


82 


83 


84 


85 


87 


88 


89 


91 


91 


93 


900,000 - 1 ,000,000 


74 


78 


80 


82 


84 


85 


86 


87 


88 


90 


92 


93 


94 


95 


96 
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Table F-2. Optimum Keys/Block 



Blocks in File 














KeyS 


ze in Bytes 
































11 
to 


16 
to 


21 

to 


26 

to 


36 
to 


51 
to 




2 


3 


4 


5 


6 


7 


8 


9 


10 


15 


20 


25 


35 


50 


100 


- 5,000 


16 


17 


18 


18 


18 


19 


19 


19 


19 


20 


20 


20 


21 


21 


21 


5,000- 10,000 


20 


21 


22 


23 


23 


23 


24 


24 


24 


25 


25 


25 


26 


26 


26 


10,000- 15,000 


23 


24 


25 


26 


26 


27 


27 


27 


27 


28 


29 


29 


29 


30 


30 


15,000-20,000 


26 


27 


28 


28 


29 


29 


29 


30 


30 


31 


32 


32 


32 


33 


33 


20,000 - 25,000 


28 


29 


30 


31 


31 


32 


32 


32 


33 


34 


34 


34 


35 


35 


36 


25,000 - 30,000 


29 


31 


32 


32 


33 


34 


34 


34 


35 


36 


36 


37 


37 


37 


38 


30,000 - 35,000 


31 


32 


33 


34 


35 


35 


36 


36 


37 


37 


38 


38 


39 


39 


40 


35,000 - 40,000 


32 


34 


35 


36 


36 


37 


37 


38 


38 


39 


40 


40 


41 


41 


42 


40,000 - 45,000 


34 


35 


36 


37 


38 


38 


39 


39 


40 


41 


41 


42 


42 


43 


43 


45,000 - 50,000 


35 


36 


37 


38 


39 


40 


40 


41 


41 


42 


43 


43 


44 


44 


45 


50,000 - 60,000 


37 


39 


40 


41 


42 


42 


43 


43 


43 


45 


45 


46 


46 


47 


48 


60,000 - 70,000 


39 


41 


42 


43 


44 


44 


45 


45 


46 


47 


48 


48 


49 


49 


50 


70,000 - 80,000 


40 


42 


44 


45 


46 


46 


47 


47 


48 


49 


50 


50 


51 


52 


52 


80,000 - 90,000 


42 


44 


45 


47 


47 


48 


49 


49 


50 


51 


52 


52 


53 


54 


54 


90,000-100,000 


44 


46 


47 


48 


49 


50 


50 


51 


51 


53 


54 


54 


55 


56 


56 


100,000- 125,000 


47 


49 


51 


52 


53 


54 


54 


55 


55 


57 


58 


58 


59 


60 


61 


125,000-150,000 


50 


52 


54 


55 


56 


57 


58 


58 


59 


61 


61 


62 


63 


64 


64 


150,000- 175,000 


52 


55 


57 


58 


59 


60 


61 


61 


62 


64 


65 


65 


66 


67 


68 


175,000-200,000 


55 


57 


59 


61 


62 


63 


63 


64 


65 


67 


68 


68 


69 


70 


71 


200,000 - 250,000 


59 


62 


64 


65 


67 


68 


68 


69 


70 


72 


73 


74 


74 


75 


76 


250,000 - 300,000 


63 


66 


68 


69 


71 


72 


73 


73 


74 


76 


77 


78 


79 


80 


81 


300,000 - 350,000 


66 


69 


71 


73 


74 


75 


76 


77 


78 


80 


81 


82 


83 


84 


85 


350,000 - 400,000 


69 


72 


74 


76 


78 


79 


80 


81 


81 


84 


85 


86 


87 


88 


89 


400,000 - 450,000 


72 


75 


77 


79 


81 


82 


83 


84 


85 


87 


88 


89 


91 


91 


93 


450,000 - 500,000 


74 


78 


80 


82 


84 


85 


86 


87 


88 


90 


92 


93 


94 


95 


96 


500,000 - 600,000 


79 


82 


84 


87 


89 


90 


91 


92 


93 


96 


97 


98 


100 


101 


102 


600,000 - 700,000 


83 


87 


90 


92 


94 


95 


96 


97 


98 


101 


102 


103 


105 


106 


107 


700,000 - 800,000 


87 


91 


94 


96 


98 


99 


100 


102 


102 


105 


107 


108 


110 


111 


112 


800,000 - 900,000 


90 


94 


97 


100 


102 


103 


105 


106 


106 


110 


111 


112 


114 


115 


116 


900,000 ■ 1 ,000,000 


93 


98 


101 


103 


105 


107 


108 


109 


110 


113 


115 


116 


118 


120 


121 
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Table F-3. Optimum or Minimum Index Block Size 



Optimum block size = 


10 + 


(10) (OKBI (KS+4) 1 
9 1 

0KB - Opitimum keys/block 
KS = Key size 


Minimum block size = 


= 10 + 


J (10) (MKB) (KS+4) I 

MKB = Minimum keys/block 
KS = Key size 



NOTE: 



I)" 



Round up if result not whole integer. 



Table F-4. Bytes Required in Buffer for Directory-Directory Entries 



Usage -p^]- US 



Number keys/primary index block =[ K „ +4 J - NKP 



Number keys/directory block = K o+2 I- N 
Total number keys represented/ 



KD 



directory block 



Number entries in 



Directory-directory block I NKRD 



= (NKP) (NKD) NKRD 
file size 



NKDD 



Number of bytes required for 

buffer for directory-directory = 10 + (KS+2) (NKDD) 



NOTE: 



Round up if result not whole integer. 
Round down if result not whole integer. 
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Table F-5. Constants for Alternate Algorithm 



KS 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 



K„ 



1 .2500 
1 .0888 
.9877 
.9184 
.8681 
.8299 
.8000 
.7759 
.7562 
.7396 
.7256 
.7136 
.7031 
.6940 
.6859 
.6787 
.6722 
.6664 
.6612 
.6564 
.6520 
.6480 
.6443 
.6409 
.6378 
.6348 
.6321 
.6296 
.6272 
.6249 
.6228 
.6209 
.6190 
.6172 
.6156 
.6140 
.6125 
.6111 
.6097 
.6084 
.6072 
.6060 
.6049 
.6038 
.6028 
.6018 
.6009 
.6000 
.5991 
.5983 



m 



2.5000 

2.1776 

1 .9753 

1 .8367 

1.7361 

1.6598 

1.6000 

1.5518 

1.5124 

1 .4792 

1.4512 

1.4272 

1 .4062 

1.3880 

1.3718 

1 .3574 

1 .3444 

1 .3328 

1 .3224 

1.3128 

1 .3040 

1.2960 

1 .2886 

1.2818 

1 .2756 

1 .2696 

1.2642 

1.2592 

1.2544 

1.2498 

1.2456 

1.2418 

1.2380 

1.2344 

1.2312 

1 .2280 

1.2250 

1 .2222 

1.2194 

1.2168 

1.2144 

1.2120 

1.2098 

1 .2076 

1.2056 

1 .2036 

1.2018 

1.2000 

1.1982 

1.1966 



KS 



52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 



.5975 


1.1950 


.5967 


1.1934 


.5959 


1.1918 


.5952 


1.1904 


.5945 


1.1890 


.5939 


1.1878 


.5932 


1.1864 


.5926 


1.1852 


.5920 


1.1840 


.5914 


1.1828 


.5908 


1.1816 


.5903 


1.1806 


.5897 


1.1794 


.5892 


1 .1 784 


.5887 


1.1774 


.5882 


1.1764 


.5878 


1.1756 


.5873 


1.1746 


.5868 


1.1736 


.5864 


1.1728 


.5860 


1.1720 


5856 


1.1712 


5852 


1.1704 


,5848 


1.1696 


5844 


1.1688 


.5840 


1.1680 


.5837 


1.1674 


.5833 


1.1666 


.5830 


1.1660 


.5827 


1.1654 


.5823 


1.1646 


.5820 


1.1640 


.5817 


1.1634 


.5814 


1.1628 


.5811 


1.1622 


.5808 


1.1616 


.5805 


1.1610 


.5802 


1.1604 


.5800 


1.1600 


.5797 


1.1594 


.5794 


1.1588 


.5792 


1.1584 


.5789 


1.1578 


.5787 


1.1574 


.5785 


1.1570 


.5782 


1.1564 


.5780 


1.1560 


.5778 


1.1556 


.5776 


1.1552 
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INDEX 



ABEND macro 


7-1,37;B-37 


Buffer description table 




ACCEPT macro 


5-2;7-1,34; 


general description 


2-12 




B-32 


indexed files 


2-29-34 


Access 




relative files 


2-24-28 


random 


2-1 


sequential files 


2-20-23 


sequential 


2-1 


BUFSIZ parameter 


7-15,24,27,28 


Action macros 


B-1 






Add mass storage space 


7-5 


Catalog elements 




ALLOC macro 


3-1,3;6-1; 


attribute 


2-3,6 




7-1,2,3;B-6 


continuation 


2-3;A-6,9 


Allocate space 


7-3 


name 


2-3,4; 


Assumed block number 


3-2 




A-4,5 


Attribute element 


2-3,6 


space 


2-3,8;A-3 






volume 


2-3,10 


BDT 


2-12,20-34 


CATALOG parameter 


7-3,5,6 


sequential files 


2-20-23 


Central catalog 


2-3;A-1;4,7 


relative files 


2-24-28 


CHAIN parameter 


7-24,27, 


indexed files 


2-29-34 




28,30 


Bit significance 


7-22 


Change current block number 


7-12 


BLKNUM parameter 


7-11,12,13 


Close file for data transmission 


7-7 


BLKSIZ parameter 


7-3 


CLOSE macro 


3-3;7-1,7; 


Block I/O 






B-14 


coding 


3-2 


Close volume 


7-8 


declarative macro 


7-1,2 


CLOVE macro 


3-1,3;6-1; 


device control commands 


3-3 




7-1,8;B-15 


error processing 


3-4 


CNTBUF parameter 


7-28,29 


file control 


3-3 


CNTRL macro 


3-2,3;7-1, 


general description 


1-2 




13;B-18 


macros 




CNTSIZ parameter 


7-28,29 


CNTRL 


7-1,13;B-18 


COMMAND macro 


7-24 


POSITN 


7-1,12;B-18 


basic data channel 


7-24;B-23 


READ 


7-1,10;B-19 


DCABLE 


7-24;B-24 


RESET 


7-1,21 


DCJUMP 


7-30;B-29 


STATUS 


7-1,15;B-17 


DCREAD 


7-28;B-27 


TYPE 


7-1,15;B-17 


DCSEEK 


7-24;B-25 


WRITE 


7-1,11;B-19 


DCSRCH 


7-27;B-26 


positioning 


3-3 


DCWRIT 


7-29;B-28 


program 


3-5,6 


RESTORE 


7-30;B-29 


reading 


3-2 


Command program 


4-1 


request termination 


3-4 


Common stored data format 


2-1 


rules 


3-1 


CON parameter 


7-3,5 


sense information 


3-4 


Console communication macros 




space management 


3-3 


CONSOLE 


7-1,37,38; 


writing 


3-2 




B-39 


BREAK parameter 


7-31 


MESSAGE 


7-1,38 


BUFADR parameter 


7-7,15,24,27 


CONSOLE macro 


7-1,38;B-39 



lndex-1 



CONTROL parameter 


7-7 


Control program macros 




ABEND 


7-1,37;B-37 


ACCEPT 


7-1,34;B-32 


DELAY 


7-1,31;B-35 


DISPLAY 


7-1,35 


EHALT 


7-1,37;B-36 


GETCOM 


7-1,33;B-31 


HALT 


7-1,36;B-36 


INFORM 


7-1,31;B-33 


JDATE 


7-1,37;B-38 


MEMLIM 


7-1,35;B-33 


POST 


7-1,32;B-31 


RPOST 


7-1,32;B-31 


SDATE 


7-1,37;B-38 


SETCOM 


7-1,33;B-31 


SETIF 


7-1 ,36;B-34 


TIME 


7-1,37;B-37 


WAIT 


7-1,30;B-30 


Control program services 


5-1 


finding partition size 


5-1 


inter-step and control language 




communication 


5-1 


reading data from //PAR cards 


5-2 


service request control 


5-1 


writing to SYSOUT 


5-2 


CP parameter 


7-22 


CPADR parameter 


7-23 


Create communication byte 


7-32 


CSD parameter 


7-3,34 


CWADR parameter 


7-30 


CYCLES parameter 


7-31 


Data macros 


B-1 


Data structures 


2-1 


DATACYL parameter 


7-3 


DATATXT parameter 


7-38 


DATBUF parameter 


7-10,12,28, 




29,35 


DATABUF1 parameter 


7-34,38 


DATABUF2 parameter 


7-38 


DATSIZ Parameter 


7-10,12,28, 




29,35 


DATSIZ1 parameter 


7-38 


DATSIZ2 parameter 


7-38 


Define file label 


7-2 


Defining and opening devices 


4-1 


DEFLB macro 


7-1,2 


DELAY macro 


5-1:7-1,31; 




B-35 


Device and file type 


7-15 


Device control commands 


3-3 


DEVTYP parameter 


7-23 



Disc catalog 




central 


2-2,3;A 1, 




4,7 


pack 


2-2,3;A-1,2 


Disc track format 


E 1 


DISPLAY macro 


5-2;7-1,35 


EBCDIC parameter 


7-10,12 


EHALT macro 


7-1,37;B-36 


ELEMENT parameter 


7-9 


End conditions 




EOF 


3-3 


EOA 


3-4 


EOT 


3-4 


ENDADR parameter 


7-34 


ERRCOMP parameter 


3-4;7-3, 




5 thru 10,12 




thru 15,21,23, 




30 thru 36; 




B-4 


ERROPT parameter 


4-3;7-23 


Error log record 


C-7 


Error logging 


C-2 


Error processing 


3-4 


Error recovery 




types of errors 


C-1 


intervention required 


C-1 


retries 


C-1 


information 


C-3 


uncertain conditions 


C-1 


irrecoverable conditions 


C-2 


error logging 


C-2,7 


EXCP instruction 


4-1 


EXCP macro 


7-1,22;B-21 


Expand from communication byte 


! 7-32 


EXPND macro 


3-3;6-1;7-1, 




2,5;B-9 


FDT 


2-12,13 thru 




19;3-4;7-2 


FIELD parameter 


7-27,28,30 


File control 




general description 


3-3 


macros 




CLOSE 


7-1,6,7; 




B-14 


CLOVE 


7-1,6,8; 




B-15 


OPEN 


7-1,6;B-12 


File description table 


2-12,13 thru 




19;3-4;7-2 


File label (tape) 


2-1,2 


File organization 


2-1 


FILE NAM parameter 


7-2 



lndex-2 



FILEORG parameter 
Files 

indexed 

relative 

sequential 
FILESIZ parameter 
FILETYP parameter 
Fixed length records 
FUNCTN parameter 

GAP parameter 
Gap specification 
Generation of reply buffer 
GETCOM macro 



HABUF parameter 
HALT macro 

Hardware control operation 
HASIZ parameter 

IDENT parameter 

Identify partition limit 
I N DC YL parameter 
Index block size 
Indexed files 
INDSIZ parameter 
INFOADR parameter 

INFORM macro 

Input/output action 
Input/output levels 

logical 

block 

physical 
Interaction of Data Management 
and Control Language 
I/O service macro (LABRTM) 
IOTYP parameter 

J DATE macro 

KEYBUF parameter 
KEYSIZ parameter 

LABDEF parameter 
LABDEF1 parameter 
LABDEF2 parameter 
Labels 

tape 

disc 
LABRTN macro 



7-3 


LIST parameter 


2-1 




2-1 


LOCK parameter 


2-1 


Logical I/O 


7-3,4,5 




7-3,4 


Macro expansions 


2-1 


Macros 


7-23 


ABEND 




ACCEPT 


7-29 




D-1 


ALLOC 


7-38 




5-1;7-1,33; 


CLOSE 


B-31 






CLOVE 


7-28,29 




7-1,36;B-36 


CNTRL 


7-13 




7-28,29 


COMMAND 


7-3 thru 10, 




12 thru 15,21 


CONSOLE 


7-35 


DEFLB 


7-3,4 


DELAY 


F-1 




2-1 


DISPLAY 


7-3,4 


EHALT 


7-9,32,33, 


EXCP 


36,37 


EXPND 


5-1,7-1,31; 




B-33 


GETCOM 


7-22 






HALT 


1-1 


INFORM 


1-1,2 




1-1,2 


JDATE 




LABRTN 


6-1 


MEMLIM 


7-1,9;B-16 




7-7,8 


MESSAGE 




OPEN 


7-1,37;B-38 






PCB 


7-28,29 


POSITN 


7-3,4,28,39 






POST 


7-5,6,7 




7-3,4 


PURGE 


7-3,4 






READ 


2-1,2 




2-2,3 


RESET 


7-1,9;B-16 





7-3 thru 10, 
12 thru 15,21, 
30 thru 36;B-3 
7-8 
1-1 

B-1,5 

7-1,37;B-37 

5-2;7-1,34; 

B-32 

3 1,3;6-1; 

7-1,2,3;B-6 

3-3;7-1,7; 

B-14 

3-1,3;6-1; 

7-1,8;B-15 

3-2,3;7-1, 

13;B-18 

4-1 ;7-24 thru 

30;B-23 thru 

29 

7-1,38;B-39 

7-1,2 

5-1;7-1,31; 

B-35 

5-2;7-1,35 

7-1,37;B-36 

7-1,22;B-21 

3-3;6-1;7-1, 

2,5;B-9 

5-1;7-1,33; 

B-31 

7-1,36;B-36 

5-1;7-1,31; 

B-33 

7-1,37;B-38 

7-1,9;B-16 

5-1;7-1,35; 

B-33 

7-1,38 

3-3;6-1;7-1, 

6;B-12 

7-1,23;B-22 

3-2,3;7-1, 

12;B-18 

5-1;7-1,32; 

B-31 

3-3;6-1;7-1, 

2,5;B-11 

3-2,3;7-1, 

10;B-19 

3-2,3,4; 

7-1,21 



lndex-3 



Macros (continued) 




Parameters (continued) 




RPOST 


5-1;7-1,32; 


DATATXT 


7-38 




B-31 


DATACYL 


7-3 


SDATE 


7-1,37;B-38 


DATBUF 


7-10,12,28, 


SETCOM 


5-1;7-1,33; 




29,35 




B-31 


DATBUF1 


7-34,38 


SETIF 


5-1,7-1,36; 


DATBUF2 


7-38 




B-34 


DATSIZ 


7-10,12,28, 


STATUS 


3-2;7-1,15; 




29,35 




B-17 


DATSIZ1 


7-38 


TIME 


7-1,37;B-37 


DATSIZ2 


7-38 


TYPE 


3-2;7 1,15; 


DEVTYP 


7-23 




B-17 


EBCDIC 


7-10,12 


WAIT 


5-1;7-1,30; 


ELEMENT 


7-9 




B-30 


ENDADR 


7-34 


WRITE 


3-2,3;7-1, 


ERRCOMP 


3-4;7-3,5 




11;B-19 




thru 10, 


MEMLIM macro 


5-1;7-1,35; 
B-33 




12 thru 15, 
21,23,30 


MESSAGE macro 


7-1,38 




thru 36;B-4 


MODE parameter 
MSC parameter 
MULTBLK parameter 
Multi-volume file processing 


7-30,37,38 
7-2 
7-11 
3-4 


ERROPT 

FIELD 

FILENAM 

FILEORG 

FILESIZ 


4-3;7-23 

7-27,28,30 

7-2 

7-3 

7-3,4,5 


Name element 


2-3,4;A-5 


FILETYP 
FUNCTN 


7-3,4 
7-23 


OPCODE parameter 


7-24,27 
thru 30 


GAP 
HABUF 


7-29 
7-28,29 


OPEN macro 


3-3;6-1 ; 


HASIZ 


7-28,29 




7-1,6;B-12 


IDENT 


7-3 thru 10, 


OPER parameter 


7-11,12,14 




12 thru 15,21 






INDCYL 


7-3,4 


Pack catalog 


2-3;A-1 ,2 


INDSIZ 


7-3,4 


PAIRED parameter 


7-5,6 


INFOADR 


7-9,32,33, 
36,37 


Parameters 
BLKNUM 
BLKSIZ 
BREAK 
BUFADR 


7-11,12,13 

7-3 

7-31 

7-7,15,24,27 


IOTYP 
KEYBUF 
KEYSIZ 
LABDEF 


7-7,8 
7-28,29 
7-3,4,28,39 
7-5,6,7 


BUFSIZ 


7-15,24,27, 


LABDEF1 


7-3,4 




28 


LABDEF2 


7-3,4 


CATALOG 


7-3,5,6 


LIST 


7-3 thru 10, 


CHAIN 


7-24,27,28, 




12 thru 15, 




30 




21, 30 thru 


CNTBUF 


7-28,29 




36;B-3 


CNTSIZ 


7-28,29 


LOCK 


7-8 


CON 


7-3,5 


MODE 


7-30,37,38 


CONTROL 


7-7 


MSC 


7-2 


CP 


7-22 


MULTBLK 


7-11 


CPADR 


7-23 


OPCODE 


7-24,27 


CSD 


7-3,34 




thru 30 


CWADR 


7-30 


OPER 


7-11,12,14 


CYCLES 


7-31 


PAIRED 


7-5,6 
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Parameters (continued) 




PURGE macro 


3-3;6-1;7-1, 


PARNUM 


5-2;7-34 




2,5;B-11 


PCB 


7-22 






RECSIZ 


7-3,4 


Random access 


2-1 


REQADR 


7-30 


READ macro 


3-2,3,7-1 , 


REQCNT 


7-30,32 




10;B-19 


RETURN 


4-1 ;7-3 thru 


Reading data from //PAR cards 


5-2 




10,12 thru 15, 


Read //PAR card 


7-34 




21,23,32 thru 


Records 






36;B-4 


fixed length 


2-1 


REWIND 


7-7,8 


variable length 


2-1 


SECONDS 


7-31 


RECSIZ parameter 


7-3,4 


SEEK 


7-13 


Relative files 


2-1 


SIZERR 


7-24 


Release disc file space 


7-5 


SKIP 


7-24,28 


Report of status 


7-15 


SPREAD 


7-3,4 


REQADR parameter 


7-30 


STRIP 


7-34 


REQCNT parameter 


7-30,32 


UNORD 


7-22 


Request 




USAGE 


7-7 


overlap 


3-3 


VERIFY 


7-3,4 


termination 


3-4 


PARNUM parameter 


5-2;7-34 


Reset exception conditions 


7-21 


PCB 




RESET macro 


3-2,3,4; 


general description 


4-1 




7-1,21 


macro 


7-1,23;B-22 


Retrieve 




parameter 


7-22 


system date 


7-37 


Peripheral device hardware codes 


7-25 


time of day 


7-37 


Physical 




Return file label information 


7-9 


command block 


4-1 


RETURN parameter 


4-1 ;7-3 thru 


control block 


7-23 




10,12 thru 15, 


request termination 


4-3 




21,23,32 thru 


Physical I/O 






36;B-4 


coding 


4-1 


Returned information format 


7-16 


error processing 


4-3 


REWIND parameter 


7-7,8 


general description 


1-2 


RPOST macro 


5-17-1,32; 


macros 






B-31 


EXCP 


7-1,22;B-21 






PCB 


7-1,23;B-22 


SDATE macro 


7-1,37;B-38 


operation 


4-1 


SECONDS parameter 


7-31 


overlap 


4-3 


SEEK parameter 


7-13 


program 


4-4 


Sense information 


3-4 


request termination 


4-3 


Sequential 




restrictions 


4-3 


access 


2-1 


POSITN macro 


3-2,3;7-1, 


files 


2-1 




12;B-18 


Service request mechanism 




Post code for Control Language 


7-36 


complete bit 


B-3 


POST macro 


5-1,7-1,32; 


CONTROL 


5-1 




B-31 


end flag 


B-3 


Priority 


3-3 


error flag 


B-3 


Processing considerations 




function code 


B-3 


end conditions 


3-3 


instruction 


B-1 


multi-volume files 


3-4 


length 


B-3 


priority 


3-3 


linkage 


B-2 


request overlap 


3-3 


return code 


B-3 






return information 


B-3 
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Set up message format 
SETCOM macro 

SETIF macro 

Sharing 

an EXCP 

aPCB 
SIZERR parameter 
SKIP parameter 
Space element 

Space management 
general description 
macros 
ALLOC 

EXPND 

PURGE 

SPREAD parameter 
Standard system suffixes 
STATUS macro 

Status word 

data channel 

disc channel 
STRIP parameter 
Suspend program execution 



7-38 

5-1;7-1, 

33;B-31 

5-1;7-1,36; 

B-34 

4-2,3 

4-1,2 

7-24 

7-24,28 

2-3,8; 

A-3.A-6 

3-3 

7-1,2,3; 

B-6 

7-1,2,5; 

B-9 

7-1,2,5; 

B-11 

7-3,4 

B-4 

3-2;7-1,15; 

B-17 

7-19 
7-20 
7-34 
7-31 



Tables 
FDT 

BDT 

Tape labels 

volume 

file 
Terminate program 
TIME macro 
TYPE macro 



UNORD parameter 
USAGE parameter 

Variable length records 
VERIFY parameter 
Volume element 
Volume label 

disc 

tape 

Wait for service request 

completion 
WAIT macro 

WRITE macro 

Write message on SYSOUT 
Writing to SYSOUT file 



2-12,13 thru 
19;3-4;72 
2-12,20 thru 
34 

2-1,2 

2-1,2 

7-36,37 

7-1,37;B-37 

3-2;7-1,15; 

B-17 

7-22 
7-7 

2-1 

7-3,4 

2-3,10;A-9 

2-2,3 

2-1 



7-30 

5-1;7-1,30; 

B-30 

3-2,3;7-1, 

11;B-19 

7-35 

5-2 
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COMMENTS FORM 



MRX/OS Control Program and Data Management Services 
Extended Reference Manual (2200.002) 



Please send us your comments, to help us produce better publications. Use the space below to 
qualify your responses to the following questions, if you wish, or to comment on other aspects of 
the publication. Please use specific page and paragraph/line references where appropriate. All 
comments become the property of the Memorex Corporation. 



Yes No 

Is the material: 

Easy to understand? □ □ 

Conveniently organized? O O 

Complete? D D 

Well illustrated? D D 

Accurate? D D 

Suitable for its intended audience? D D 

Adequately indexed? d D 

For what purpose did you use this publication? (reference, general interest, etc.) 
Please state your department's function: 



Please check specific criticism(s), give page number(s), and explain below: 



O Clarification on page(s) 

□ Addition on page(s) 

D Deletion on page(s) 

D Error on page(s) 



in 
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Postage Will Be Paid By 

Memorex Corporation 
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Thank you for your information. 



Our goal is to provide better, more useful manuals, and your 
comments will help us to do so. 



.Memorex Publications 



